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Introduction 


This book was written for the person who wants to get the most out of his or her ATARI computer. 
If you have a good understanding of BASIC but want to know how to get more special effects, more 
sounds, and more graphics from your computer, this book is for you. Every program is explained 
in detail so that after you enter the program and understand how it works, you can use this 
knowledge in writing your own programs. 

All the programs will run on any ATARI personal computer. The ATARI BASIC cartridge 
CXL4002 and ATARI DOS (for disk programs) were used in creating them. 

Memory locations that are used by the Operating System are presented. Explanations are 
given on how to change their values for different programming effects. The chapters on the disk 
explain the file structure to give you control over the drive. Everything is included here to make 
you an Advanced Programmer! 

There is a chapter on creating your own character sets, mixing graphic modes, using the 
player/missile graphics, and flipping screens. You will even learn how to enter a machine- 
language subroutine to play music while a BASIC program is running! 


XI 





Note: Because many of the listings in this book use graphics characters and/or reverse video, the 
following codes have been used in the listings: 

• > clear > Press the escape key and the shift/clear key. This clears the screen. 

• ’/characters or letters}- Press the control key and the letter indicated between the brackets.,4// 
characters or letters between the brackets >> are graphic characters. 

• Underlined characters or letters are in reverse video. 




Chapter 1 

Working 
with Numbers 


Ever since man had the need to know how many items he had in his possession, how much grain he 
needed, or how many days since the last rain, he has had to devise counting systems. It is believed 
that some ancient tribes used the base two, or three for counting. There is some evidence that 
base twenty was used by a few early tribes, since their handiest counting device was their fingers 
and toes. 

With numbers came the need to do simple calculations. Soon the problems were no longer 
simple, and man quickly learned that if he marked the numbers in the dirt or on a tablet he could 
compute much faster. Stones were probably used much the way we use poker chips today with 
each type of stone representing a different group of numbers—ones, fives, tens, etc. The figures 
themselves evolved from crude lines and shapes to the forms we are familiar with today. 

The abacus is the oldest, and yet the simplest, adding machine invented. The principle of 
moving the beads on rods has survived the test of time. Many people consider the abacus to be the 
first type of computer. 

BINARY SYSTEM 

As with the abacus, the computer uses its own number system—binary. If you think of a light 
bulb, a candle, a lock, or a trap, each item has only two states. It can be either on or off, open or 
closed, set or sprung. The computer operates in the same manner. Each memory location in the 
computer can be either on or off. 

The memory in your computer can hold a charge. This is represented by the number one. 
When a location has no charge, it is represented by a zero. The computer, then, uses binary or 
base 2 as its number system. 

In our decimal system, each number position is a multiple of ten. The position to the left of 
the decimal is the unit position. In the binary system, each position is a multiple of 2 with the 
position to the left of the decimal the unit position. In the decimal system, there are ten numerals, 
0 through 9. In the binary system, only the numerals 0 and 1 are used. The binary number 10110 is 
22 in decimal. To convert a binary number to decimal, we add the places that contain a 1 and ignore 
the place values where there is a zero. 
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1 

2 6 3 1 

8 4 2 6 8 4 2 1 

0 0 0 1 0 1 1 0 

In our example, 10110, there is a 1 in the 16’s column, a 1 in the 4’s column and a 1 in the 2’s 
column. If we add 16+4+2, we arrive at 22, the decimal equivalent of 10110. Most computers 
have 8 positions in each memory location. This means that each location can contain a number 
from 0 to 255. 

The number that is stored in each memory location is called a byte. Each one or zero in the 
byte is referred to as a bit. The ATARI computer is an 8-bit computer. There are some 4-bit and 
16-bit computers also. Each byte can also be divided into two 4-bit nybbles. 

Although it seems confusing at first, using the binary system in computers conserves on 
space and increases speed. If a switch with ten different settings were used, the computer would 
first have to determine whether or not the switch was set, and then determine which setting it was 
pointing to. In binary, there are only two possibilities, a 1 or a 0. It takes only 8 bits or switches to 
count to 255. By adding 8 more, any number up to 65535 can be displayed. Work the following 
examples to practice converting binary numbers to decimal. 

1 . 01100001 

2 . 10110111 

3. 11001000 

4. 00111001 

5. 01110010 

6. 00111100 

7. 00011110 

8. 11011000 

9. 01111010 

10. 11110001 

The decimal equivalents are: 1-97; 2-183; 3-200; 4-57; 5-114; 6-58; 7-30; 8-216; 9-122; 
10-241 

UNDERSTANDING HEX 

Although the binary system increases the computer’s speed, most of us cannot readily 
convert a string of Is and 0s into a number that we can understand. To help us, most programmers 
and manuals reference the memory locations and the numbers stored in them in hex. The 
hexadecimal system uses the base 16. The numbers after 9 are represented as the letters A-F. To 
convert a binary number to hex, we first divide the byte into two nybbles. If, for example, we 
needed to convert 11001101 into hex, we would divide it into two nybbles: 1100 and 1101. Each 
nybble consists of four bits. Now we treat each nybble as a separate number. By adding the place 
values of the first nybble, 8+4, we get 12. Twelve is not a one digit number, so we use the letter 
C. The next nybble is 8+4+1, or 13. One number higher than C is D. Our hex number for 
11001101 is CD. 

Let’s try that again with another binary number: 10010111. Divide this 8-bit number into 2 
nybbles: 1001 and 0111. The first nybble is 8+1 or 9, the second is 4+2+1 or 7. The hex number 
for 10010111 is ‘97’. 

There are times when you will want the decimal equivalent to a hex number. When you are 
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working in BASIC and want to poke a location with a number, both the location and the number 
that you are poking must be in decimal. Often the manual you are using will provide only the hex 
addresses to be poked or the hex values that should be entered. To convert a hex number to 
decimal is fairly easy. Since each number/letter represents a value from one to 15, each place 
value in hex is a multiple of 16. If the hex number has only two place, for example, B3, you should 
multiply the number in the second position from the end by 16 and add the value in the rightmost 
position. B is equal to 11 decimal, 11x16 is 176. Add 3 and the decimal value of hex B3 is 179. 
Since the computer can access over 64000 memory locations, the hex number will often contain 
four places. To convert C253 hex to decimal we would multiply the C (decimal 12) by 4096, the 2 
by 256, the 5 by 16 and add 3. 

(12x4096)+(2x256)+(5xl6)+3=49747 

To convert a decimal number to hex, you should divide the number by the largest place value 
feasible; the quotient is the value for that place. Then divide the remainder by the next place 
value, and continue until there is a remainder less than 16. That number is the last number of the 
hex number. If, for example, the decimal number is 21013, we would divide the number by 4096. 
The first or leftmost value of the hex number then is a 5. The remainder is 533. When this number 
is divided by 256, the next quotient is a 2 with a remainder of 21. 21 divided by 16 is 1 with a 
remainder of 5. 

Therefore, the hex equivalent of 21013 is 5215. 

-5 ...2 -l 5 

4096) 21013 256)533 16W 

-20480 -512 -16 


533 21 5 


The following program will convert a decimal number to hex or binary, and a binary or hex 
number to decimal. 


Listing 1-1. Conversions 


10 REM 
20 REM 
30 REM 
40 DIM 


LISTING 1,1 

BY L♦M♦SCHREIBER FOR TAB BOOKS 
CONVERSIONS 

A $ ( 8 > : R E M M 0 S T p 0 SIT10 N S IN A B 
INARY NUMBER 

5 0 G R A P HIC S 0 i P 0 K E 7 5 2 y 1 1 ? " > C I... E A R > " : P 
0 K E 710 y 10 0 : P 0 K E 712 y 10 0 J C 01... 0 R 18 t PI... 0 T 

7 y 2 : D R A LI T 0 3 3 y 2 J PI... 0 T 7 y 4 t D R A W T 0 3 4 y 4 

6 0 R E M P RIN T c n t r I ■••• R t o m a k 0 t h (••? t o p a 
n d b o 11 o m o f b o x ♦ 

70 POSITION 6 y 2 t ? n ! "JPOSITION 3 
4 y 2 ♦ ? " ! " t R E M c r 1 1 r 1 - R y 0 s c - c n t r 1 - 
d o w n a r r o w y 0 s c — e n t r I - b a e k a r r a w y & h :i. f t 
8 0 R E M c n t r .1. - R y a h :i. f t - 9 o r i t r' I -■ 2 & c n t v k - 
E y s h :i. f t :::: y c.' n t r 1 — c w :i. t 'n d o w n •••• a r r a w b b c 
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Listing 1-1. Conversions (continued from page 3). 


kiurrow to make left & right sides 
9 0 P 0 SIT10 N 8 9 3? ? " P1. e as e e n t e r a s e 1 e 
ct j. on ? " 

100 ? ?? i? " 1. Decimal to Hex"IRE 

M escTAB 

110 ? J? " 2. Decimal to Dinars"?RE 

i v i esc TAB 

120 ? ?? " 3. Hex to Decimal"?REM e 

sc T AB 

13 0 ? ? ? " 4 * B i i"i a r y t o D e c i m a 1" ? P 0 


1 <■ D e c :i. in a 1 t o H e x " ? RI: 


2 •> D e c i m a 1 t o B i n a r y" ? R E 


H e x t o D e c i m a 1 " ? R E M e 


13 0 ? ? ? " 4 . B i n a r y t o D e c i m a 1" ? P 0 

KE 752 y 0 ? REM escTAB 


1 4 0 T R A P 1 4 0 ? P 0 SIT 1 0 N 1 9 y 1 A ? ? " " i ? 

INPUT NiREM TWO SPACES - 2 esc-cntrl b 


INPUT NJREM TWO SPACES -• 2 esc-cntrl b 

Ack arrows erase a previous answer 

150 IF NCI. OR N>4 THEN 140? REM CHECK F 

OR CORRECT INPUT 

160 ON N GOSUB 200 v 500 y 700 >- 900 

170 GOTO 50 

190 REM ROUTINE TO CONVERT DECIMAL NLJM 
BERS TO HEX 

200 ? " I-CLE AR>PL_E A SE ENTER THE DEC IM 
AL NUMBER TO BE CONVERTED TO HEX."?? " 


AL NUMBER TO BE CONVERTED TO HEX."?? " 
NUMBEH CANNOT EXCEED 65534 . " 

205 REM CLEAR SCREENv 2 esc-cntrl down 


210 ? ?? "TO EXIT THIS ROUTINEv SIMPLY 
P R E S S T l-l E R E T U R N K E Y . " ? ? ? ? 

220 TRAP 50 
230 INPUT N 

250 IF N>65535 OR N<0 THEN 200 

260 N1 -N ? REM STORE THE NUMBER ENTERED 

FOR THE CONVERSION ROUTINE 

270 P-1?D~4096?REM P IS THE HEX POSITI 

ON - D IS EQUAL TO THE VALUE OF THE HE 

X POSITION 

2SO GOSUB 390?REM USE THE SUBROUTINE T 
HAT GETS THE FIRST POSITION 
290 P-2 ? D-256 ? REM P IS THE NEXT POSITI 
ON - D IS THE VALUE OF THAT POSITION 
300 GOSUB 390 

310 P=3? D-16? REM P IS THE THIRD POSITI 
ON •••• D IS THE VALUE OF THAT POSITION 
320 GOSUB 390 
330 P-4? D=1 


ro EXIT THIS ROUTINEv SIMPLY 
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340 GOSUB 400 

350 ? J ? " T H E H E X E Q UIV A L E N T 0 F ” 5 N 5 " 
IS *JA$ 

360 GOTO 2.1.0 

380 REM THIS ROUTINE DOES THE ACTUAL C 
ONVERSION 

3 9 0 IF N1 < D T H E N A $ ( P r P ) ~ S T R $ (OK R E TIJ R 
N 

4 0 0 H •- IN T < N1 / D ) J R E M DIVID E T H E N U M B E R 
BY THE VALUE OF THE POSITION 

410 N . 1 . = N1 ~ 1-1 * D : R E M S T 0 R E T H E R E M AIN D E R 
F 0 R T H E N E X T C 0 N V E R S10 N 
4 2 0 IF H > 9 T H E N A * ( P t P ) = C H R $ ( H f 5 5 ) l R E T 
URN 

4 30 A $ ( P r P ) a S T R $ ( H ) t R E T IJ R N 
490 REM CONVERT A DECIMAL NUMBER INTO 
A BINARY NUMBER - DIVIDE THE NUMBER BY 
EACH PLACE VAI. 

500 ? 


II * 


> C L E A R :>• P L. E A S E E N T E R T H E D E CIM 


AL NUMBER TO BE CONVERTED TO BINARY KK 
? ” NUMBER CANNOT EXCEED 255 K' 

505 REM CLEAR SCREENx 2 esc-cntrl down 


510 


'? 


J? "TO EXIT THIS ROUTINE? SIMPLY 


;, RESS 


RETURN KEY, 11 J? 


•> 


520 TRAP 50 
530 INPUT N 

550 IF N>255 OR N<0 THEN 500 
560 N:L“N J REM STORE THE NUMBER ENTERED 
F 0 R T H E C 0 N V E R S10 N R 0 IJ TIN E 
5 70 P=1 J D :: = 12 8 : R E M P IS T H E BIN A R Y P 0 SI 
TION -• D IS EQUAL TO THE VALUE OF THE 
BINARY POSITION 

580 GOSUB 390 S REM USE THE SUBROUTINE T 
HAT GETS THE FIRST POSITION 
590 P=2:D=64:REM P IS THE NEXT POSIT10 
N - D IS THE VALUE OF THAT POSITION 
600 GOSUB 390 
610 P«3:D*32JGOSUB 390 
620 P~4J D-161GOSUB 
5 J D~8J GOSUB 

6:d=4:gosub 390 

7JD=2JG0SUB 390 


390 


7 \ 


630 P 
640 P 
650 P 

660 P-8 1 11=1 ♦ GOSUB 400 




Listing 1-1. Conversions (continued from page 5). 


670 ? :? "THE BINARY ECU'VALENT OF " > N1 
? "IS ■fA$(l»4>»* "?A$<5»8> 

6 80 GOTO 510 

700 ? ">CLEAR>PLEASE ENTER THE HEX N 
U M B E R T 0 B E C 0 N V E R T E D T 0 D E CIM AI... ♦ " i ? " 
N u M B b K L.: A N N U l I- A u b 0 i-1- E l- * “ 

710 ? 1? "TO EXIT THIS ROUTINE r SIMPLY 
P R E S S T H E R E T U R N K E Y ♦ " t ? 1 ? 

720 N==0? INPUT A$ 

730 IF A*="■ THEN 50 

7 4 0 P ~ L E N ( A $ ) J R E M FIN D 0 U T H 0 W M A N Y P 0 
SITIONS 

750 IF P>4 THEN 700 

7 6 0 l :: ' 0 R D« 1 T 0 P ? C :::: A S C < A $ ( D v D ) ) ? IF C > 7 
0 T1-1E N 7 0 0 ? R E M IN V A I... ID L E T T E R / C H A R A C T E 
R 

7 7 0 C ~ C - 5 5 11F C < 10 T H E N C=V A L ( A $ ( D t D ) ) 
I REM IF IT'S NOT A LETTER THEN GET THE 
VALUE 

780 ON P-D+l GOTO 820y810y800y790 
790 N SS C*4096 * NEXT D 
800 N-N+C*256?NEXT D 
810 N~N+C#.1.6?NEXT D 
820 N--N+C 

830 ? ?? "THE DECIMAL EQUIVALENT OF "y 
A * t J ? " IS 11 y N 
840 GOTO 710 

900 ? “ >CL„EAR>PI...EASE ENTER THE DINAR 
Y NUMBER TO BE CONVERTED TO DECIMAL,"? 


? " N LJ M B E R C A N N 0 T E X C E E D 1111111 1 ♦ " 

910 ? ?? "TO EXIT THIS ROUTINEy SIMPLY 


-•RESS 


THE RETURN KEY,"?? 


920 N-OJINPUT A$ 

930 IF A $~"" THEN 50 

9 4 0 P - L E N < A $ ) ? R E M FIN D 0 U T H 0 W M A N Y P 0 
SITIONS 

950 IF P>8 THEN 700 

960 TRAP 900?FOR D=1 TO PJC=VAL(A*(Dy0 
) ) 

970 IF C>1 THEN 900?REM INCORRECT ENTR 
Y 

980 IF C=1 THEN ON P-D+l GOTO 1060y105 
0 y 104 0 y 10 3 0 y 102 0 y 1.010 y 10 0 0 y 9 9 0 
985 NEXT D 
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990 N=C*128JNEXT D 


1000 
1 010 
1020 
1030 
1040 
1050 
1060 
1070 
y A $ J ? 


N 

N 

N 

N 

N 

N 


•-N+OK64J NEXT 
=N + PK32 l NEXT 
=N+C*16iNEXT 
=N+C3K8 1 NEXT D 
»N+C*4JNEXT D 
=N+C*2JNEXT D 


D 

D 

n 


N-N+C 


:? 


IS 


"THE DECIMAL 

“ yN 


1080 GOTO 910 
1090 END 


EQUIVALENT 


li 


Line 40 sets the string space used for the binary or hex numbers. 

Line 50 removes the cursor, clears the screen, changes the color of the background and 
border to violet, and draws the top and bottom of the box. To use the plot and DRAWTO 
commands, you must specify the graphics mode. The color 18 is a control R. 

Line 70 draws the right and left side of the box for the on-screen display. Use a control Q, 
shift =, and a control Z for the left side of the box; and a control E, shift =, and a control C for the 
right side. Use a down arrow and a backspace between each character. 

Lines 90-130 place the menu on the screen. Keep it neat by using an extra print and a tab in 
each line. 

Line 140 uses the trap command. If a letter or character is entered instead of a number, the 
program will not crash. The two spaces and backspaces will clear any input that was incorrect. 

Line 150 checks the input. If the number entered is incorrect, the program goes back to the 
previous line and waits for the correct entry. 

Line 160 directs the program to the correct routine. The program will return to the menu in 
line 170. 

Lines 200-210 clear the screen and place the directions on the screen. 

Line 220 is another trap. If you enter a letter or simply press the return key, you will return 
to the main menu. When writing a menu driven program, it is a good idea to give the user a way out 
in case the wrong selection was made. 

Lines 230-250 get the number to be converted and check to make sure that the number is 
within the specified range. If it is not, the program will go back to the beginning of this routine. 

Line 260 stores the number entered in another variable, Nl. The number in this variable will 
be converted to a hex number. 

Lines 270-340 convert the number into a hex number. The variable P is the position that is 
being converted. When converting numbers from decimal to hex or binary, we start with the 
leftmost position and work to the right. The value of the first hex position in a four digit hex 
number is 4096. This number is stored in the variable D. The program then uses the subroutine 
that begins with line 390 to convert the number. Each time we return from this subroutine, the 
value in P is increased by one to reflect the next place in the number and the value of D changes to 
the value of the place. In line 340 we GOSUB to line 400 since this is the last or one’s position and 
the value here will most likely be larger than the value of D. 
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Lines 350-360 display the number entered and its hex equivalent. The program goes back to 
line 210 and waits for another number or a return. 

Lines 390-430 do the actual conversion of a decimal number to hex or binary. First the 
number is compared to the place value. If the number is less than that value, a zero is stored there. 
Next the number is divided by the place value. The integer or whole number is stored in the 
variable H. To get the remainder, we multiply the place value by the whole number and subtract it 
from the number. The new number or remainder is now stored in N1 and will be used when we 
continue to convert the number. Line 420 is used for decimal to hex conversions. The number is 
checked to see if it is greater than a 9. If it is, it must be converted into a letter (A-F). This is done 
by adding 55 to the number. If the number is less than 10, that number is placed into the string. In 
either case, the routine returns to continue the conversion. 

Lines 500-680 convert a decimal number to binary. Again, we trap the input so that pressing 
the return key will return you to the main menu. The number is tested and stored in Nl. Lines 
570-660 keep track of which position is being converted and the value of that position. The same 
subroutine that was used to convert the decimal number to hex is used to convert the decimal 
number to binary. 

Lines 670-680 display the results of the conversion and go back to the beginning of this 
subroutine. 

Lines 700-840 convert a hex number to decimal. This time we are using a string for the input. 
If the string is empty, the program will go back to the main menu. The program checks the length 
of A$. If more than 4 letters or numbers have been entered, the program will go back to the 
beginning of this subroutine. The ASCII value for each number/letter is stored in C. If the value of 
C is greater than 70, the letter entered is invalid and the program goes back to the beginning of 
this subroutine. If it is a valid letter/number, 55 is subtracted from it. If C is less than 10, that 
position contains a number and its value is placed in C. If the position contains a letter, the value of 
that letter is obtained by subtracting 55 from its ASCII value. The value in C is multiplied by the 
place value of its position and added to any previous conversion value. The new conversion value 
is stored in N. Once the hex number has been converted into its decimal equivalent, both numbers 
are displayed on the screen. This subroutine continues until the return key is pressed. 

Lines 900-1080 use the same principle to convert a binary number to decimal. Since the 
program is expecting only Is and 0s, a trap is placed in line 960 for any letter/character. The value 
of each position is stored in C, one at a time. If this value is greater than 1, the program returns to 
the beginning of this module. If C is 1, the value of that position is added to the value in N. This 
number will be the decimal equivalent of the binary number. 
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Chapter 2 

Working with 
the Display List 


All microcomputers have one thing in common—a CPU or central processing unit. It is the brains 
or workhorse of the system depending on how you look at it. Whether it is a 6502, 8080, Z-80, or 
some other processor, it is what keeps the machine going. The ATARI, however, has three 
special-purpose LSI (large-scale integrated) chips to take some of the burden off the 6502. They 
are called ANTIC, CTIA, and POKEY. This chapter will discuss the purpose of ANTIC and how to 
make use of its capabilities. 

THE PURPOSE OF ANTIC 

ANTIC is a microprocessor that is dedicated to updating the screen display. It is a true 
microprocessor because it has its own instruction set, a program, and data. It operates simultane¬ 
ously and in conjunction with the 6502. ANTIC uses the same bus and memory locations that the 
6502 does. In order to operate, ANTIC must stop or halt the 6502, get its information, and then let 
the 6502 continue its work. Both must operate without missing a step. 

ANTIC’s job is to keep the screen updated with the current information. A television screen 
is normally updated 60 times a second. Since ANTIC must stop the 6502 each time it does its job, 
the higher the resolution that is displayed on the screen, the more often the 6502 will be 
interrupted. If you turn off the ANTIC chip completely, the 6502 will operate at maximum 
efficiency. 

The ATARI computer and many other personal computers like the Apple and the TRS-80 
have memory mapped screen displays. This means that the information that you see on the screen 
is also stored in a specific portion of the computer’s memory. The higher the graphics resolution, 
the more memory is needed to store this information. The upper left corner of the screen is the 
lowest memory address, and the lower right corner is the highest memory address. The address 
of each location in between follows the first address sequentially. In most other computers, you 
have a choice of one or two graphic modes, or text. It is not always possible to mix the types of 
graphics modes. The ATARI offers 14 different modes with its CTIA graphics chip. Each mode 
can be displayed individually or mixed with the others. This is the reason for the ANTIC chip. It 
has its own program just above the memory set aside for the screen. This program is really a list of 
the graphics modes that we are using in our program. ANTIC checks this list for the mode of the 
line, and sends this information along with the data that will be displayed on this line to the CTIA 
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(or GTIA) chip. This chip is the television interface chip. It in turn converts the information that it 
receives into the signal that we see as a picture or text on the screen. If each line is a different 
mode, ANTIC tells this to the CTIA (GTIA) chip, and it translates the signal accordingly. 

FINDING THE DISPLAY LIST 

Just before the memory set aside for the screen display is the display list that ANTIC uses. 
The address of the display list is stored at memory locations 560 and 561. To obtain the address of 
the display list enter this command. 

PRINT PEEK(560)+PEEK(561)*256 

The number that appears on the screen is the starting address of the display list. In graphics mode 
0, the display list is 32 bytes long. To see the list type: 

10 DLIST=PEEK(560)+PEEK(561)*256 

20 FOR X-DLIST TO DLIST+31:? PEEK(X):NEXT X 

Your list should look like: 

112 

112 

112 

66 

64 may 
156 differ 

2 - 
2 - 

2 — (23 twos) 

2 - 
2 - 

65 

32 may 
156 differ 

Before interpreting the display list, you must understand your screen. If you look very 

closely at the screen, you will see that each character is made up of tiny dots. The picture that you 
see on the screen is actually many rows of dots stacked from the top of the screen to the bottom of 
the screen. You do not actually see the complete picture on the screen. The parts of the picture 
that are above, below, or to the sides of the screen are called overscan . The picture that is 
transmitted from the networks contains information on the lines above the actual picture. You 
never see this information because it is in the overscan area. 

Now look at the display list again. The first three numbers tell ANTIC to display three blank 
lines that are 8 rows high. This makes sure that the text or picture will be on the screen and not in 
the overscan area. 

The next number, 66, is a two part instruction. A 64 tells ANTIC that the following two bytes 
contain the address of the beginning of the screen display area. The 2 added to the 64 is the 
ANTIC mode of the first line of the screen. Any number from 2 to 15 can be added to the 64. The 
number added is always ANTIC’s value for the graphics mode. We will discuss the fourteen 
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graphics modes and their ANTIC values later in this chapter. For now, your screen is in graphics 
mode 0, which is ANTIC mode 2. 

If you multiply the sixth number in the display list by 256 and add the fifth number of the 
display list, you would know the exact memory location of the first location in the first line on the 
screen, or position 0, 0. If you poked this location or any location after this one with a value, you 
would see characters on your screen. This is a memory mapped screen display. The contents of 
the memory locations set aside for the screen are visible on the screen. When you use the locate 
command in BASIC and you tell the computer LOCATE 5,6,B, the computer calculates the 
memory location of the fifth column and the sixth row based on the mode that we are using and 
sets the variable B to the value in that memory location. If your screen display begins at memory 
location 40000 (40K system), and you are in graphics 0, you can use the locate command to find out 
what is stored on the screen at any location. The command in this example is LOCATE 5,6,B. The 
computer multiplies the row number by the number of characters in the row, in this case 40, and 
adds the column number: 6 times 40 plus 5 equals 245. This number is added to the first memory 
location for the screen. The computer examines that memory location and changes the value 
found there to ATASCII. This value is stored in B, and the computer can tell you the value of 
location. Now that you know how it’s done, you can use either the locate command, or the peek 
function for yourself. 

Going back to the list of numbers that make up the display list, you see that there is a string of 
23 twos before you come to any other numbers. In graphics mode 0, there are 24 rows on the 
screen. ANTIC knows from the display list that the first row is in graphics mode 0. It also knows 
where the beginning of the screen display is. The next 23 numbers tell ANTIC that the next 23 
rows will all be in graphics mode 0 or ANTIC mode 2. The next number after all the twos is a 65. 
This again is a two part instruction. The 64 tells ANTIC that there is an address in the next two 
bytes that it should jump to, and the 1 tells ANTIC to wait for a vertical blank before jumping. 

When the last number in this list is multiplied by 256 and then the number just before it is 
added to this product, the total is equal to the beginning address for this display list. Thus ANTIC 
will repeat these same instructions over and over again until they are changed. It will start at the 
beginning of the display list, look at the mode the first line is in, take the information from the 
screen display area, and transfer this information to the CTIA chip for the actual screen display. It 
goes to the next line, looks at the mode, gets the next lines information, and transfers it. The 
process is repeated until it reaches the 66, where it waits for a signal called a vertical blank and 
goes back to the beginning of the display list. 

What’s a vertical blank? The picture that you see on your television screen, whether it’s 
generated by a computer or comes from the main television station, is “painted” on your screen 
line by line. A beam called a raster scan starts at the left side of the screen (as you look at it), and 
paints a picture by turning on the correct color beams in that row. When it reaches the end of the 
row, the beam shuts off, retraces the line, steps down a row, and turns itself back on to paint 
another line on the screen. The line that has been painted is called a horizontal scan line. The time 
that the beam is shut off to retrace the line is called a horizontal blank. When the beam reaches the 
last row on the screen, it not only has to come back to the left side of the screen, but also has to go 
back to the top of the screen. This period of time, while the beam is shut off and going back to the 
top side of the screen, is called the vertical blank. If the computer was not synchronized with the 
television, the display would appear jittery and distorted. By waiting for the vertical blank before 
beginning the display list again, ANTIC is sure that the display will appear correctly on the 
screen. 
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ANTIC’S INSTRUCTION SET 

Looking at the display list again, you see that ANTIC does have a set of instructions that it 
follows. A blank line can be inserted anywhere in the display list. This blank line can be from one 
to eight pixels tall. In the display list, the first three numbers were 112, 112, 112. In hex this 
translates to 70, 70, 70. When you want to tell ANTIC to send a blank line, you use an instruction 
that only uses the left nybble of the byte. Table 2-1 shows the values used to issue a blank line 
from one to eight pixels high. 

ANTIC is also capable of jumping. At the end of the display list, it has the instruction 65. In a 
jump instruction, the second nybble of the byte is always set to 1. The first nybble can be either 0 
or 4 hex. If the instruction is 1, ANTIC will jump to the address indicated in the next two bytes, 
and continue there. If the instruction is 65 or 41 hex, ANTIC will wait for the vertical blank before 
jumping. The jump instruction, 1, is used when the display list must cross a IK boundary in 
memory. ANTIC cannot calculate past 255, so it must be told to jump to the next location. This 
jump should be placed just before the boundary. The two bytes after the jump instruction should 
contain the low order and then the high order address of the location that ANTIC should jump to. 

ANTIC also has display instructions. This time the instruction byte is divided into its 
individual bits. The last four bits of this byte tell ANTIC which display mode to use. ANTIC’s 
display modes are 2 - 15. If bit 4 is set to 1, then ANTIC can do a horizontal scroll. If it is 0, it 
cannot. Bit 5 is set to enable the vertical scroll and when bit 6 is set, ANTIC will use the next two 
bytes as the beginning of the screen memory. See Fig. 2-1. 

COMBINING GRAPHICS MODES 

Looking at the ATARI manual, you see that there are eight graphics modes, one for normal 
text, two for color text, and five for graphics. Yet, looking at ANTIC’s instruction set, you can see 
that there are fourteen different modes. Six of these modes cannot be accessed by BASIC with the 
graphics command. They can, however, be used with BASIC when you create your own display 
lists. 

Combining the different graphics modes and creating your own display list takes a little 
imagination and the ability to add to 192. Why 192? Think back to the television screen and the 
horizontal scan. The beam that paints a picture on the screen does so row by row. Every row is the 
same height. Therefore, every picture has the same number of scan lines. When you count the 
number of pixels used in a character in graphics mode 0, you see that the character stands 8 pixels 
or rows high. There are 24 rows in mode 0. 24 x 8 = 192. Multiply the number of rows for any 
other mode time the number of pixels used in one row. The answer will always be 192. Therefore, 


Table 2-1. Values to Issue Blank Lines. 


blank 

hex 

decimal 

lines 

value 

value 

4 

1 

00 

0 

2 

10 

16 

3 

20 

32 

4 

30 

48 

5 

40 

64 

6 

50 

80 

7 

60 

96 

8 

70 

112 
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bit # 

7 6 5 4 3 2 1 0 


set bit 

instruction 


7 

display list instruction interrupt 

Fig. 2-1. Set bits for display list. 

6 

load memory scan with next two bytes 


5 

vertical scroll 


4 

horizontal scroll 


3-0 

display mode 



when you create a new display list, you want the number of rows used in each of the modes to total 
192. 

To create a multi-mode screen, you must first decide what you want your screen or display to 
look like; which graphics modes are best suited for the display; and how you want to organize the 
general layout of the screen. Once you decide how the screen should look, you are ready to create 
a new display list. As an example you are writing a program that involves some text, some 
prompting from the program, and a score that is kept on the screen. The main part of the program 
will be done in graphics mode 7. The first thing that you have to decide is how many lines you need 
for the text. This program will only need two lines for text: one line at the top and one line near the 
bottom. This leaves the rest of the screen for the graphics. In a full screen (no text window), 
graphics mode 7 has 96 rows, each 2 pixels high (96x2=192). For this program you will use 
graphics mode 2 at the top and graphics mode 1 near the bottom. To calculate the number of rows 
that will be in graphics mode 7, you must first determine the number of rows of pixels the other 
two modes will use. The characters in graphics mode 2 are 16 rows high. The characters in 
graphics mode 1 are only 8 rows high. This means that 24 rows of the screen will be used by these 
two modes (8+16=24). By subtracting this number from 192, you can calculate that there are 168 
rows left for graphics mode 7 (192-24=168). Since each row of graphics mode 7 uses two rows of 
pixels, there will be 84 rows of graphics mode 7 on the screen (168/2=84). The following 
program, which draws a baseball diamond, creates a new display list for your program. 

Listing 2-1. Mixed Modes Program 


10 REM LISTING 2*1 
20 REM MIXED MODES 

30 REM BY L♦M♦SCHREIBER FOR TAB BOOKS 

j 9 0 2 

4 0 DIM M $ ( 2 0 > : G R A P HIC S 2 3 : R E M H A 0 E C 0 M 
PLITER' SET DISPLAY LIST FOR GRAPHICS 7 
WITH NO TEXT WINDOW 

5 0 D LIS T = P E E K ( 5 6 0 ) + P E E K ( 561) * 256 

6 0 ANTI C = P E E K ( 5 59 > J R E M G E T T H E V A I... U E I 


N THE SHADOW FOR ANTIC? 


a f q 


STATE 


70 POKE 559 y 0 i REM SHUT OFF ANTIC FOR D 
ISPLAY LIST CHANGES 

80 POKE DEIST+ 3 > 71J REM MAKE THE FIRST 
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Listing 2-1. Mixed Modes Program (continued from page 13). 


LINE GRAPHICS 2 


9 0 P G K E D I... IS T •}• 8 9 y 6 i R E M M A K E 
ROUJ GRAPHICS 1 

10 0 P 0 K E D LIS T + 9 0 r 6 5 l R E M M 0 VI 


THE BOTTOM 


THE JUMP 


■EEK < 560 > 
■EEK ( 561 ) 


110 POKE DL. IST f 91 r I 
1.20 POKE DLIST+92 y I 
1.30 POKE 559y ANTIC? REM TURN ANTIC BACK 
ON TO IT'S PREVIOUS STATE 

14 0 M E M 0 R Y=P E E K < B I... IS T + 4 ) + P E E K < D I... IS T+5 ) 
#256 

15 0 M $ = " 0 2 % 3 3 0 (0 S / 2 0 ( ) 4 ” l R E M IN V E R S E 0 
PEN PARENTHESIS - FIRST ONLY 

160 BOTTOM== MEMORY* 2 

17 0 F 0 R X » B 0 T T 0 M T 0 B 0 T "f 0 M+1... E N ( M $ ) -1 5 P 
0 K E .X t A S C ( M $ < ( X •••• B 0 T T 0 M + J.) y ( X •••• B 0 T T 0 M +1 > 
)) t NEXT X 

18 0 M $ = " 2 5 ♦ 3 0 0 0 0 0 0 2 5.3 " i R E M L A S T F 
C H A R A C T E R S A R E IN V E R S E 

19 0 B 0 T T 0 M ~ 8 3 * 4 0 + M E M 0 R Y + 2 2 
2 00 F 0 R X=B 0 "f T 0 M T 0 B 0 T T 0 M + L E N ( M * ) 

0 K E X y A S C ( M $ ( ( X •••• B 0 T T 0 M+ . 1 . > r < X •••• B 0 T T 0 M +1 ) 
))1 NEXT X 

210 COLOR 1 l PLOT 0 v 11 BRAWTO 60y401 HRAW 
T 0 0 y 8 0 t P L 0 T 15 9 v 0 i B R A W T 0 9 9 y 3 9 1 B R A W T 0 
159y79 

250 GOTO 250 


.1. 1 P 


Line 40 sets M$ to 20. This string will be used to store the characters for the message that 
will appear, on the screen. The graphics mode is set to 23, which is graphics mode 7 without the 
text window. Of the three modes that will be used, graphics 7 mode uses the most memory, so it is 
advantageous to set the mode to 7. The computer will calculate the amount of screen memory 
needed and move the display list above it. This leaves you with less to figure out. 

Line 50 finds the address for the beginning of the display list. 

Line 60 stores ANTIC’s state in the variable ANTIC. The value in this memory location 
varies depending on what control the program will have. It determines the width of th eplayfield 
and the resolution of players and missiles, and enables the use of player/missile graphics. 

Line 70 turns off ANTIC while the display list is changed. If ANTIC was left on, it would be 
using the values in the display list while it was being changed. This could cause the program to 
crash. 

Line 80 changes the first row on the screen from graphics mode 7 to graphics mode 2. 
Remember, you must add the display instruction to the graphics mode in this location. 

Line 90 changes the last row on the screen to graphics mode 1. You must add 89 to the display 
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list to arrive at the position of the last row of the screen in the display list 89 is obtained in the 
following manner: 

1. The total number of rows on the screen, calculated in terms of graphics mode 7, are 
tabulated. This number is 96. (Each row is two pixels high.) 

2. The total number of rows, calculated in terms of graphics mode 7, done in modes 1 and 2 are 
calculated. Row 1, which is in mode 2, is 16 pixels or 8 mode-7 rows high. The last row, 
which is in mode 1, is 8 pixels or 4 mode-7 rows high. The total (8+4) is 12. 

3. The 12 from item number two is subtracted from the 96 obtained in item one: 96-12=84. 
These are rows 0-83 in terms of graphics mode 7. We know that the first three bytes of the 
display list (0-2) are for the overscan. The fourth byte (3) sets the first row on the screen, 
and the next two bytes (4 and 5) indicate the memory location of the screen. 83+5=88— 
therefore the 89th row in the display list is set for graphics mode 1. 

Lines 100-120 move the jump and the address of the beginning of the display list into the 
correct position. 

Line 130 turns ANTIC back on to its previous state. Now it can execute the new display list. 
Line 140 finds the location of the screen memory in the display list and stores it in the 
variable MEMORY. We will use this value when we display the message on the screen. 

Line 150 places the message in M$. The first open parenthesis is in inverse video. If you 
have been replacing the character set in your ATARI with a new character set in RAM, you have 
probably discovered that the character set does not follow its ATASCII or decimal values. 
Because we have set the graphics mode to 7, the computer will not print a message as such on the 
screen. Graphics mode 7 means: “use only two bits from every byte; add four 2-bit combinations 
together and store them in a memory location on the screen.” If we told the computer to 
PRINT“PRESS” on the screen, it would use only the last two bits of each letter between the 
quotation marks. The PRES would be combined for one character, the S would be the second. 
The character on the screen would be the character that was in that location of the ATARI 
character set. In the next chapter we will redesign a character set. 

Line 160 stores the value of MEMORY + 2 in the temporary variable BOTTOM. 

Line 170 is a for . . . next loop that pokes each character of M$ into the memory that is 
reserved for the screen. Now the ATASCII value of each character of M$ is stored directly on the 
screen. 

Line 180 stores a new message in M$. This is the message that will appear on the bottom of 
the screen. Once again, the message that appears on the screen is not the same as the characters 
between the quotes. 

Line 190 calculates the memory location of the last row on the screen. 

Line 200 pokes this message directly into the screen memory. 

Line 210 draws the diamond on the screen. This can be done with the simple plot and 
DRAWTO commands. Notice that the position PLOT 0,1 is actually the center of the screen 
rather than the left side. All the positions are shifted over by 80. This often happens when 
different modes are mixed. Our first row on the screen is in graphics mode 2. ANTIC took the first 
80 bytes for this row because it was set for graphics mode 7 which uses 4 bytes for every location 
on the screen. It knew, though, that graphics mode 2 only needed 20 locations on the screen 
(20x4=80). Graphics mode 7 uses 160 bytes for every line. The next 160 bytes are displayed on 
the next row on the screen. The computer thinks that the first 80 bytes belong to the previous 
row. When the computer calculates the memory position for PLOT 0,1 , though, it does not look at 
the display list to see if any of the rows have more or less bytes in them than the present mode 
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calls for. It simply multiplies the row number by the number of bytes in a row. Because this is a 
graphics mode, before it adds the column, it divides by the number of bytes used to display one 
byte (in this mode, 4) and then adds the column divided by 4. Every row on the screen will be off 
center because of this method of calculation. 

Line 250 loops back on itself. You can stop this program by pressing the system reset key. 

THE FOURTEEN MODES 

One of the features of the ATARI that has not been widely publicized is that the number of 
graphics modes is not 9 but 14 with the CTIA chip. When we are working with BASIC, we have 9 
choices, Graphics modes 0-8. Graphics mode 9-11 are reserved for the GTIA chip. Any other 
number will give us an error message. However, when we work directly with the display list, we 
learn that ANTIC will set the screen for any graphics mode from ANTIC 2 to ANTIC 15. Table 2-2 
shows us the different modes and the unique features of each mode. ANTIC modes 2-7 are all text 
modes. ANTIC modes 8-F are graphics modes. ANTIC gives you three additional text modes and 
two additional graphic modes. 

TEXT MODES 

There are two 2-color text modes available: the standard text mode referred to as Graphics 
mode 0, and ANTIC mode 3. ANTIC mode 3 has ten scan lines or rows for each character. This 
feature allows for true descenders on the letters q, y, p, j and for subscripts and superscripts. 
Because each line in this mode uses ten scan lines or rows on the screen, the display will be two 
rows shorter than a normal display (10x19=190) or eight rows longer (10x20=200). 

When you redefine a character set for use in this mode, you do not need to add two blank 
bytes either before the character or after it. When the computer reads the bytes for the characters 
from the character set, it will add the two blank bytes automatically to the character. For all the 
characters, numbers, and uppercase letters, the two blank bytes will be added to the bottom of the 
letter. Lowercase letters are treated differently. The computer takes the first and second byte of 
the character and places it in the ninth and tenth row of the character on the screen. It places 2 
blank lines in the first and second row and then places the rest of the bytes in the correct position. 
This can cause some problems if you are using this mode with the character set in ROM. 

In the following program, the display list will be changed to use ANTIC 3. A message will be 
printed on the screen using the character set from ROM. Notice the distortion in the letters 1, j, 
and k. There is no distortion in any of the capital letters, numbers, or graphics because they are 
not the last 32 characters/letters of the character set. 


value in two 
bits of 

color 


graphic byte 

register 


5 oo 

0 (background) 

Fig. 2-2. Color register codes. 

01 

1 

10 

2 


11 

3 


All four color registers are used in GRAPHICS 3, 5, 7. 


Color registers 0 and 1 

are used in GRAPHICS 4 and 6. 
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Listing 2-2. ANTIC 3 


10 REM LISTING 2.2 
20 REM ANTIC 3 

30 REM BY L.M.SCHREIBER FOR TAB BOOKS 
40 ? " 3Aa Bb Cc Dd Ee Ff Gd Hh 1'i JJ 
Kk LI Mm Nn Go Pp Q« Rr Ss Tt Uu Vv U 
w Xx Ya Zz y5!#*%8780<)90“ 

5 0 D LIS T ~P E E K (5 6 0 ) + P E E K (5 61 ) * 2 5 6 X A N TIC 
=P E E K ( 5 5 9 ) X R E M G E T T H E V A I... U E IN T H E S H 
ADOW FOR ANTICS'S STATE 
60 POKE S59rOJREM SHUT OFF ANTIC FOR D 
ISPLAY LIST CHANGES 

70 POKE DL1ST + 3*67 $ REM MAKE THE FIRST 
LINE ANTIC 3 

80 FOR X-6 TO 24JPOKE DLISTTX v 3 X NEXT X 
5 REM CHANGE LIST FOR ANTIC 3 
90 POKE D i... IS T T 2 5 y 6 5 t R E M MOVE THE JUMP 
10 0 P 0 K E D LIS T+2 6 » P E E K ( 5 6 0 ) 

110 l :: ‘ 0 K E D I... IS T }• 2 7 t P E E K ( 5 61) 

120 POKE 559 y ANTIC X REM TURN ANTIC BACK 
ON TO IT'S PREVIOUS STATE 
13 0 A=P E E K ( 10 6 ) - 8 X N B -- A Y 2 5 6 X R E M P L A C E C 
HARACTER SET 2K BEFORE END OF MEMORY •••• 
STORE VALUE IN NB 

140 CB~PEEK(756)*256JTH-CB X X=TH X REM CH 
ARACTER SET IN ROM 

15 0 F 0 R I... C = 0 T 0 11 J P 0 K E N B r P E E K ( X+7 ) X N 
B=N B T 1 ! F 0 R X = T H T 0 T H + 6 X P 0 K E N B v P E E K ( X 
) J N B=N B +1 X N E X T X X T H = T H T 8 X X « T H X N E X T L C 

16 0 F 0 R X = T H T 0 T H + 7 * P 0 K E N B r P E E K ( X ) X N 
B - N B +1 X N E X T X X T H ~ X X R E M S A M E 

17 0 F 0 R L C •“ 13 T 0 2 6 X P 0 K E N B y P E E K ( X+7 ) X 
N B= N B + .1. J F 0 R X=T H T 0 T H+6 J P 0 K E N B r P E E K ( 
X ) X N B=N B +1 X N E X T X X T H=T H+8 X X = T H X N E X T L C 

18 0 F 0 R X = T H T 0 T H+7 5 P 0 K E N B r P E E K ( X ) X N 


B N B 

■f 1 X NE 

V T V <• 

/\ 1 /\ <• 

TH = 

= X X R 

EM SAME 


1 9 0 

FOR 1... 

n •• ■") o 

**** A*.. 1,) 

T 0 

64 t 

POKE 

NB y 

PEEK(XT7) X 

NB--NBT1 X F 

OR X = 

TH 

T 0 

TH + 6 X 

P 0 K 

E NBy PEEK( 

X ) ♦ N B ~ N B T 

1 { N E X 

T ) 

(: r h 

= TH+8 

♦ V —• 

♦ A 

TH X NEXT LC 

200 

FOR 1... 

| ‘ •••• X. L 

K..- •*“ vJ 

T 0 

79 X 

FOR X 

- T H 

TO THT7JP 

OKE 

NB v PE 

EK < X) 

JNI 

5 N B 

+1 J N E 

XT 

X:TH-X:NEX 

T LC 

X REM 

SAME 






210 

POKE 

N B y P E 

EK(XT7 

) X NB™ 

N BI¬ 

1 X FOR X -- TH 

TO 

TH+6 : 

POKE 

N B s 

PEE 

K ( X ) X 

ND ™ 

NBT1J NEXT 

X 

. < 

“ T H+8 

5 X = T H 

{RE 

•M F 
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Listing 2-2. ANTIC 3 (continued from page 17) 


220 FOR LC=81 TO 90JFOR X=TH TO TH+7JP 
OKE NB i- PEEK ( X ) 1 NB=NB+1 t NEXT X J TH=X 1 NEX 
T LCJ REM SAME 

230 FOR L091 TO 123 l POKE NB »PEEK (X+7 ) 
t N B ~ N B+1 J F 0 R X ~ T H T 0 T H+6 J P 0 K E N B r P E E K 
< X)JNB-NB+11 NEXT X l TH»TH+8 l X«TH 
240 NEXT LC 

250 F0R X=TH T0 T1-1+7 1 P0KE NB * PEEK ( X ) \ N 
B= NB+1 t NEXT X t I'M=X t REM SAME 
260 P0 K E NB r PEE K (X+7)J NB-NB+1 l F0R X-TH 
T 0 T l-l+ 6 t P 0 K E N B t p E E K ( X ) l N B=N B +1J N E X T 
X } TH--TH+8 J X=TH 1 REM F 

2 7 0 C B=A * 256 + 1 0 3 * 8 5 P 0 K E C B+1 1 P E E K < C B) J 
REM MOVE BYTE DOWN ONE 
2 80 P 0 K E C B t P E E K ( C B+7 ) 1R E M R E P E A T L A S T 
BYTE 

2 9 0 C B - A Y 25 6 +10 6 * 8 1 P 0 K E C B f 1 v P E E K ( C B ) l 
REM MOVE BYTE DOWN ONE 

3 0 0 P 0 K E C B r P E E K ( C B+7 ) 1 R E M R E P E A T I... A S T 
BYTE 

3 :l. 0 C B~ A *2 5 6+112 * 8 i P 0 K E C B+1 1 P E E K (OB): 
REM MOVE BYTE DOWN ONE 

320 P 0KE CB r P EEK(C B+7)J REM REPEAT LAS T 

T j V *r I!** 


3 3 0 C B=A * 2 5 6 +113 * 8 i P 0 K E C B +1 v P E E K ( C B ) J 
REM MOVE BYTE DOWN ONE 

3 4 0 P 0 K E C B 9 P E E K ( 0 B + 7 ) J R E M R E P E A T L A S T 
BYTE 

3 5 0 C B =A # 2 5 6 +1 2 1 * 8 J P 0 K E C B + 1 v P E E K ( C B) l 
REM MOVE BYTE DOWN ONE 

36 0 P0KE CByPEEK(CB + 7) t REM REPEA T L AST 


370 POKE 756fA 

Line 40 is the line that will be printed on the screen. It clears the screen and prints each letter 
of the alphabet in both upper and lowercase. It also prints some numbers, symbols, and graphics 
on the screen. 

Line 50 stores the beginning location of the display list in DLIST and the display status in 
ANTIC. 

Line 60 shuts off ANTIC so that we can change the display list. 

Lines 70-110 change the display list from ANTIC mode 2 to ANTIC mode 3. The jump 
command is moved up since there will be fewer display lines in this mode. The beginning address 
of this display list is also moved up. 

Line 120 turns ANTIC back on with the same value or status that it had before we changed 
the display list. 
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Line 130 subtracts 8 from the amount of memory available in our computer. This value is 2K 
less than the amount of memory in our computer. We will leave the top IK for the screen display 
and the display list. The second IK will be used for the character set. We will store the actual 
decimal address in NB. 

Line 140 stores the address of the character base in ROM in the variable CB. We also want to 
store this value in two more variables. Now we can manipulate the address without losing it. 

Lines 150-260 move the character set from ROM into RAM. If you look at your screen while 
the character set is being moved, you will see the distortion in several of the lower case letters. 
You will also see that the letters with descenders are no different in this mode than they are in 
mode 0. Line 150 transfers the characters from the space to the plus sign from ROM into RAM. 
When we transfer these characters, we want to take the last byte of the character and place it into 
the first byte for the character in RAM. The rest of the character will remain the same. Now the 
character will appear one scan line lower on the screen. The next character is the comma. We do 
not want to move its last byte first because the comma uses its last byte for data. The other 
characters that we just transferred do not. If we moved the comma the same way that we moved 
the other characters, the character would be distorted on the screen when it was printed because 
the data that it needs for the last row would be in the first row. The 13th through 26th characters 
will move down one scan line when they are moved. What we are doing in these lines is lowering 
all the characters one scan line so that the lower case characters that use the second byte for data 
will not be distorted on the screen (1 ,j,k,d,b,f,i,t). The characters that use the 8th byte for data, the 
graphic characters, the comma, and the semicolon are moved into RAM exactly the way they 
appear in ROM. 

Lines 270-330 move the data that is in the first byte for these letters into the second byte and 
repeat the data from the eighth byte into the first byte. These are the letters that have 
descenders. By adding one more byte of data to these letters, they will appear on the screen with 
true descenders. 

When the program is finished, move the cursor over some of the letters on the screen. You 
will see that the uppercase letters are centered and the letters with descenders are aligned with 
the last two rows of the cursor. 

The only letters or characters that place the first two bytes in the last two rows on the screen 
are the characters from the heart to the end of the character set. By replacing some of the 
lowercase letters/characters with numbers, you could create superscripts and subscripts. If you 
are not using any of the lowercase letters, you do not have to transfer the character set the way we 
did in this program. As long as you are using uppercase letters, numbers, and graphics, you can do 
a direct transfer of the characters, then create your own characters that would occupy the area 
normally used for the lower case letters. 

COLOR TEXT MODES 

As you can see in Table 2-2, ANTIC modes 6 and 7 correspond to graphics modes 1 and 2. 
These modes are capable of producing text in four different colors, plus a background color. The 
difference between these two modes is the size of the characters. Graphics mode 1 characters are 
just as high as graphics mode 0 characters, but they are twice as wide. Graphics mode 2 characters 
are both twice as high and twice as wide as graphics mode 0 characters. If you are writing a 
program where you need colorful letters, numbers, or characters of your own creation, it is much 
wiser, in terms of memory use to use one of these modes with a redefined character set than to 
use a higher resolution mode that uses more memory. 
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There are two more text modes between graphics mode 0 and graphics mode 1. These are 
ANTIC 4 and ANTIC 5. Both of these modes are unique in that they support multicolored text. 
They can also be used when you want to produce redefined characters that give the illusion of high 
resolution graphics using only a fraction of the memory. 

Normal text cannot be used in either of these modes because unlike graphics modes 1 and 2, 
these modes produce both the color and the shape of the character from the data in the character 
set. Normal text is illegible in these modes. The following program changes the display list to 
illustrate these ANTIC modes. 
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Listing 2-3. ANTIC 4 and 5 


:L0 REM LISTING 2*3 
20 REM ANTIC 4 8 5 

30 REM BY L.M.SCHREIBER FOR TAB BOOKS 

4 0 ? " > C I... E A R > " t R E M C I... E A R T H E S C R E E N 

5 0 D LIS T=P E E K (5 6 0 ) T p E E K ( 5 6 1) *256 1 R E M F 
IND THE BEGINNING OF THE DISPLAY LIST 

6 0 X=P E E K ( D LIS T+3 ) t P 0 K E D LIS T + 3 t X + 2 J R E 
M CHANGE THE FIST ROW TO ANTIC 4 

70 FOR X=DLIST+6 TO DLIST+28JPOKE X,4 J 
NEXT X i REM CHANGE ALL THE ROWS EXCEPT 
THE FIRST ONE TO ANTIC 4 

SO LIST i REM LIST THIS PROGRAM ON THE 
SCREEN TO SHOW THE MULTICOLOR MODE 
90 FOR X=1 TO 500JNEXT XJREM WASTE TIM 
E 

10 0 X=P E E K ( D LIS T+3 ) J P 0 K E D LIS T+3 r X + 1 J R 
EM CHANGE THE FIST ROW TO ANTIC 4 
110 FOR X--DLIST+A TO DLIST+28 l POKE X ? 5 
t NEXT XJREM CHANGE ALL THE ROWS EXCEPT 
THE FIRST ONE TO ANTIC 5 


120 LIST i REM LIST THIS PR( 
SCREEN TO SHOW THE MULTICt 


)GRAM ON THE 
)LOR MODE 


When this program is run, the listing is shown in vivid yellow and blue. It is nearly 
impossible to read because the letters blur into each other. ANTIC 5 is nearly the same as ANTIC 
4. The only difference is the letters/characters are larger. 

If you look again at Table 2-2 you will see that there are four different modes that support four 
colors, three character colors plus the background color. The fourth mode is sandwiched between 
graphics modes 7 and 8. With this mode, ANTIC E, each point on the screen is only one scan line 
high, but two pixels wide. It’s height is half that of a point in graphics mode 7, but it is just as wide. 
To use this mode, you would set the screen for graphics mode 8, then change every row in the 
display list from 15 to 14. This is the highest graphics resolution that is available with color. 

In this table, you will also see an additional mode for two color graphics. It is located between 
graphics modes 6 and 7. This ANTIC mode is identical to ANTIC E except for the number of 
colors that it supports. With this mode, you can only set one color plus the background color. 

Graphics mode 8 is listed as a two color mode. In actuality, it is like graphics mode 0. The 
second color depends on luminance or brightness rather than being a true second color. 

Each of the modes from ANTIC 8-F uses more memory than the text modes. With the text 
modes, each memory location is one character. If our screen display is 40 characters wide by 24 
rows, we are using 960 bytes for the screen display. The size of each character is 8x8 pixels. 
Which pixels are on and which are off is determined by the information in the character set. Each 
character uses 8 bytes of information stored in the character set. If the ATASCII value of the 
character is less that 128, the character will appear in normal video. If the ATASCII value is 
greater than 127, that is, if the high order bit is set, the character will appear in inverse video on 
the screen. The same holds true for ANTIC mode 3. 
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In graphics modes 1 and 2, which are both text modes, the character on the screen will be 
either 8x16, or 16x16. Each row on the screen is 20 bytes long. Graphics mode 2 with no text 
window uses 480 bytes of memory (24x20). Graphics mode uses 240 bytes of memory (12x20) 
for the screen display. Both of these modes use only the last 6 bits of the internal value of the 
character on the screen. The first two bits determine which color is used. This is why only half of 
the character set can be displayed at one time. (If you have redefined characters, you will know 
that the order that the characters appear in the ROM character set is not according to their 
AT ASCII value.) By using the first two bits of each byte, the computer can choose one of four 
colors for the character that will be displayed on the screen. 

00 (character) = color 0 

01 (character) = color 1 

10 (character) = color 2 

11 (character) = color 3 

The background color is set with color 4. 

The nontext modes do not follow this pattern. Graphics modes 3, 5, 7, and ANTIC mode E 
are four color modes. The character blocks on the screen can be one of three colors, the 
background is the fourth color. Each point that appears on the screen is not a byte. It is, rather, 
part of a byte. All the modes that are not text modes use only one or two bits per byte to determine 
the color that will appear on the screen. 

Graphics mode 3 displays 10 bytes in each row. With no text window there are 24 rows. 240 
(10x24) bytes of memory are used for screen display in this mode. Let’s say that we tell the 
computer to plot a point on the screen in position 0,0. We want the point to appear orange, so we 
will use COLOR1 . The computer will determine where in memory the first byte of the screen is 
located. This address is found in the display list. When the computer looks at the value of this 
byte, it should see 0000 0000 because there is nothing on the screen in this location or the next 
three locations. After the orange point is on the screen, the value of this byte of memory will be 
64. The binary value of this memory byte is 0100 0000. The first two bits now tell the computer to 
use the color in color register 1. The next three positions are left empty. If we wanted to use 
green, the color in the second color register, the value of this memory byte would be 128 decimal, 
or 1000 0000 binary. When a color is plotted in the next position, the computer changes the values 
in the next two bits of the memory byte. Refer to Fig. 2-2 for the color values and to Fig. 2-3 for a 
sample point. 

Graphics modes 5 and 7 are nearly the same. Graphics mode 5 uses 20 bytes in each row, and 
graphics mode 7 uses 40. Because of the way that the ATARI stores the color information, only 
three colors plus a background color can be displayed in these modes. If the computer used 4 bits 
per byte to display color, we could have 16 colors on the screen. Of course, the computer would 
need twice as much memory for the screen display. 

The number of pixel rows per graphic row will depend on which mode we have chosen. 
Graphics mode 3 is 8 pixels high, Graphics mode 5 is 4, and graphics mode 7 is 2. ANTIC E also 
displays three colors plus the background color. It uses one row of pixels per row. 

Graphics modes 4 and 6 can display only one color in addition to the background color. Each 
bit in the byte of memory on the screen determines whether or not that point will be on. If there is 
a 1, the color in color register 0 will appear on the screen. If there is a 0, that point will appear 
blank. Mode 4 is the same resolution as mode 5, but because each memory byte in mode 4 
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Fig. 2-3. Screen byte. 


* The four points on the screen are one byte. The color of each point is determined by two bits. In graphics mode 3, 
if the byte is 00 01 00 11, then the four points would be: off (or background), orange, off (or background), 
blue. 


represents one point on the screen, it uses half as much memory for screen display as mode 5. 
Graphics mode 4 displays 10 bytes in every row on the screen. Each point is 4 pixels high. 
Graphics mode 6 uses 20 bytes in each row. Each point is 2 pixels high. The ANTIC mode C also 
displays one color plus the background color. It displays 20 bytes in each row. Each row is one 
pixel high. 

Each of the graphics modes described above is as many pixels wide as it is high. Each point 
appears as a square on the screen. The two ANTIC modes are both two pixels wide, but only one 
pixel or scan line high. 

Graphics mode 8 is the only mode where each pixel can be individually controlled. Each row 
on the screen is 40 bytes. Each bit of each byte controls one pixel on the screen. If the bit is a 1, the 
pixel will be on. If it is a 0, it will be off. Unfortunately, the color of the on pixel is set by the 
luminance or brightness of the color in color register 1, but the actual color is the same as the 
background color. Graphics 8 uses the same amount of memory as ANTIC E. 

Remember the first program in this chapter where we poked values onto the screen? The 
computer thought that we were in a graphics mode. Each character that it was given to print on the 
screen was treated as a graphics character. That is, it took the last two bits of the character and 
stored them in a byte for the screen display. It took the last two bits of the next character and 
stored them in the next two bits of the memory byte. By poking the data directly into the screen 
memory, we were able to trick the computer into printing the characters that we wanted on the 
screen. The characters also had to be the hardware value for the characters that we wanted 
displayed rather than the ATASCII value. We will go into the differences between the hardware 
value of a character and its ATASCII values in Chapter 12. 


Listing 2-4. Color Artifacting 


10 

20 

30 

4 0 

5 0 
60 


REM LISTING 2*4 

REM COLOR ARTIFACTING 

REM BY L * M * SCI-IREI BEE FOR TAB BOOKS 

GRAPHICS 8 

D LIS T = P E E K ( 56 0 ) + P E E K C 5 61 > * 2 5 6 
C= P E E K ( D LIS T + 3 > J P 0 K E D L I S T + 3 y C - 1 


23 










Listing 2-4. Color Artifacting (continued from page 23). 


70 X 6 

80 IF PEEK(DLIST+X) 
+ X .»14 
90 IF 
X «c~ :l. 

x 


PEEK(DLIST+X) 


15 THEN POKE DL 
C THEN POKE DLI 


1ST 


C! T 


r+ 


x+ i: :i:i- x>200 then 120 

110 GOTO 80 
120 COLOR It FOR 
9JPLOT C yR♦NEXT 


0 


TO 

1 


R0 TO 9 I FOR C 
C £ NEXT R 

130 COLOR ItFOR R*10 TO 19IFOR C 
159 STEP 2 I PLOT C y RINEXT Cl NEXT R 
140 FOR R■■■■■■■ 2 0 TO 291 FOR C=0 TO 158 S 
2 I PLOT CyRINEXT Cl NEXT R 
150 STOP 


15 


TO 


TEP 


This program changes the display list to ANTIC E. Using only one color register, it paints 
different colors on the screen. 


« 
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Chapter 3 


Graphics 

Once we have decided on which mode or modes we will be using for our program, we can decide 
whether or not the standard character set will be suitable for our program. If it is, we can start 
working on the program. More than likely, if we have a particular design to our program, we will 
want to construct our own character set. We may want to redesign all the letters for special 
effects, or we may just want to recreate a few of the graphics characters for our particular 
application. Before we can redesign the characters, we must understand the size and structure of 
the character set. 

CHARACTER SET MAKE-UP 

As we determined in the previous chapter, each character in graphics 0 is 8 pixels or one byte 
wide and 8 rows or bytes high. The information to create one character on the screen occupies 8 
bytes in the character set. The entire character set uses IK or 1024 bytes of memory. This 
information is stored in ROM beginning with location 57344. 

The characters in the character set are not in ATASCII order. In order to implement the 
color text modes (graphics modes 2 and 3), ATARI chose to change the order of the characters. On 
any computer, the ASCII value of A is 65. This is true on the ATARI computer. The change occurs 
internally. When the character set is stored in ROM, the first character is the space. It is followed 
by the exclamation point, quotation marks, etc. These hold the ATASCII values 32, 33, 34. What 
has happened is that the characters from 32 - 95 have been shifted up. These are the numbers, 
symbols, and uppercase letters. The graphic characters which appear to occupy the first 32 
positions in the character set are moved to the area just past the uppercase letters and just before 
the lowercase letters as shown in Table 3-1. Now when you work in graphics modes 1 or 2, you 
can select either uppercase letters with numbers and symbols, or lowercase letters with 
graphics. 

Each character in the character set uses 8 bytes. To find the set of bytes for a particular 
character, we multiply its place in the character set by 8 and add the product to 57344. Let’s look 
at the construction of the exclamation point. It is the second character in the character set, but 
since the first character is in the zero position, the exclamation point’s place is 1. 

1 x8+57344=57352. The data to place an exclamation point on the screen begins in this memory 
location. Use the following program to PEEK at this information. 
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Listing 3-1. Data for Exclamation Point 


!LO REM LISTING 3.1 

20 REM DATA FOR EXCLAMATION POINT 

30 REM BY LINDA M. SCOREIBER FOR TAB B 


•* 

1 ) 


40 06=57344♦REM BEGINNING ADDRESS FOR 
CHARACTER SET IN ROM 

5 0 E P * 1 * 8 + C B J R E M M LJ L TIP L Y T H E L 0 C A TI (3 N 


BY 8 AND ADD THE BEG 
‘ CHARACTER SET 

:m clear the screen 

'+7: REM GET THE INFORM 


OF THE CHARACTER 
INNING ADDRESS (31 
60 ? M >CLEAR> B iRE 
70 FOR X = EP TO EF 
A T I ON 

8 0 ? p E E K ( X ) i R E M P RIN T T H E IN F 0 R M A T10 N 


90 NEXT X 


The following number should appear on your screen: 

0 

24 

24 

24 

24 

0 

24 

0 


This information determines which pixels will be turned on to form the exclamation point as 
shown in Fig. 3-1. 

Because the character set is located in ROM, it is fixed. This character set cannot be 
changed. But... there is a pointer in RAM that tells the computer where the character set begins 
(location 756 decimal). By changing the value of this location, we can point to a new character 
set—one that we have created and stored in RAM. The only limitation we have is that the 
character set must begin on an even IK boundary if we are using 1024 bytes or the entire 
character set. It must begin on an even V 2 K boundary if we are using the color text modes. The 
color text modes display only half of the character set at a time, so we do not need the entire 
character set in RAM. The character set developed and stored in RAM can be placed in any 
convenient location. Of course, it should not be in the way of the screen display, display list, or 
BASIC program. The best place for it is just before the display list. This way it is high enough in 
memory to be out of the way of our program, but it will not interfere with the screen in any way. 

RESTRUCTURING THE SET 

There are several programs on the market today to help you restructure or edit your 
character set. What these programs essentially do is move the character set from ROM into 
RAM, then display the character that you want to edit in a large form on the screen. You turn on or 
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decimal 

character 

code 


32 

space 

33 

! 

34 


35 

# 

65 

A 

66 

B 

67 

C 

0 

(cntl ,) 

1 

(contl A) 

2 

(cntl B) 

97 

a 

98 

b 

99 

c 


Table 3-1. Position of Characters in Character Set. 


off the pixels that make up the character. When you are satisfied with the character, you can store 
it in the character set. When you are finished creating new characters, you can store the new 
character set on disk or cassette. 

Another way to create a new character set is to move the character set into RAM, design 
your new characters on graph paper, set the decimal value of each of the eight rows that make up 
the character, and then poke these values over that character that you intend to replace. 

Obviously, it is much easier to create new characters with the aid of a program than it is with 
paper and pencil. If you are redesigning most of the characters in the set, you would want to use 
the first method. To redesign a few characters, you could use the pencil method. The following 
program will allow you to redesign the character set and save the new character set to disk or 
cassette. This set can then be used by any BASIC program. 


Fig. 3-1. The exclamation point. 
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Listing 3-2. Character Set Editor 


10 REM LISTING 3*2 
20 REM CHARACTER SET 
30 REM BY L.M. SCHRE] 


EDITOR 
IBER FOR 


TAB BOOKS 


4 0 DIM B $ (10 > i- C 0(7 r 7 > v N A M E $ (8 ) r N A M $ ( 14 
) y PI$ ( 20 ) 


50 DATA !y v 


! v V EDITyLETTER 


55 REM DATA ! * CTRL-GREy 


! y CTRL-ZRG 


y EDITyLETTER - CONTROL CHARACTERS FOR 
M BOX 

60 GRAPHICS 0 t POKE 752 y 1J ? "CTRL E - 
TO EDIT A CHARACTER"t ? "CTRL S - TO S 
TOP EDIT" 

70 ? "CTRL D - SAOE SET TO DISK":? " 
CTRL L - LOAD SET FROM DISK"J? "CTRL 
Q QUIT" 

80 FOR X~16 TO 23 J FOR C»6 TO .1.3 J POSIT I 
0 N X y C : ? " " J N E X T C 5 N E X T X t R E M M A K E A N 
8x8 DISPLAY WITH CTRL.-T 
90 READ B*JFOR X==9 TO 13 J READ B$ l POSIT 

ion 9yx:? b*:next x 

100 A ~ P E E K (10 6) - 8 t N C B = A Y 2 5 6 t R E M P L A C E 
NEW CHARACTER SET 2K BEFORE END OF MEM 
ORY 

110 P 0 K E 2 0 ■4 y A J P 0 K E 2 0 6 y 2 2 4 } R E M S T 0 R E 
THE NEW CHARACTER SET ADDRESS AND THE 
ROM ADDRESS 

120 FOR X-1 TO 20JREAD BJPl*(XyX)=CHR« 
( B ) : N E X T X : R E M M A C HIN E L A N GIJ A G E SIJ B R 0 U 
TINE TO MOVE CHARACTER SET 
.125 DATA 104 y 162 y 4 y 1.60 y 0 y 177 y 205 y 145 y 2 
03 y 200 y 208y249 y230y206 y230y204y202 y208 
y 242 y 96 y 

13 0 Q = U S R ( A D R ( P1 $ ) ) J R E M LJ S E M A C HIN E L. A 
NGUAGE PROGRAM WITH THE USE FUNCTION 
140 POKE 756 y A♦REM NOW WE CAN USE THE 
SET IN RAM 

150 POSITION 3 y 18 J FOR X ••••••<) TO 26 J? CHR$ 

(X)yiNEXT X:F0R X*27 T0 31 *? CHR$(27)y 
CHR$(X)y J NEXT X 

L 6 0 P 0 SIT10 N 3 y 19 i F 0 R X =-•3 2 7 0 6 3 : ? C H R 
t(X)y J NEXT X 

170 POSITION 3 y 20 l FOR X--64 TO 95 J ? CI-IR 
$(X)y♦NEXT X 

180 POSITION 3y21JFOR X~96 TO 124J? CH 
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R*(X)»JNEXT XJFOR X-1.25 TO 127j? chr$< 
27)»CHR$(X) ii NEXT X 

19 0 0PEN #Ay A»Or “K?“ i REM 0PE N K E Y B 0A RD 
FOR A READ 

200 POSITION 3 y 16 ? ? "READY FOR EDIT 

": e= o: x ••= :i. 6: c « 6: r e m p o s i t i o 

N OF FIRST CHARACTER EDIT LETTER * 

210 GET # A y B ?IF B-5 AND E=0 THEN E-156 
0T0 400 ?REM EDIT CHARACTER 
220 IF B=19 AND E = 1 THEN E="0?GQSUB 800 
JGOTO 500JREM DONE WITH THAT CHARACTER 
230 IF B-4 AND E^O THEN 1640?REM SAVE 
CHARACTER SET 

240 IF B -.17 AND E ~0 THEN POKE 756 y 224? 
P 0 K E 7 5 2 y 0 I ? 11 > " ? E N D ? R E M D 0 N E WIT hi C H 
ARASTER SET 

250 IF B-12 AND E-0 THEN .1.690? REM GET 
NEW CHARACTER SET 

260 REM USE THE NEXT 5 FOR TO EDIT A C 
HARACTER 

270 IF E™I AND B--42 THEN 650? REM GO RI 
GHT 

280 IF E = 1. AND B==43 THEN 670? REM GOT L 
EFT 

290 IF E~ : 1 AND B = 45 THEN 690? REM GO UP 


300 IF E~1 AND B“61 THEN 710?REM GO DO 

WN 

3.1.0 IF B~32 AND E*1 THEN 750? REM CHANG 
E BIT 

320 GOTO 21.0 

4 00 P 0 SIT10 N 3 y 16 ? ? " P R E S S L E T T E R T 0 E 
DIT"?GET # 4 y B 

410 IF <B>26 AND B<32) OR (B>1.24 AND B 
< 12 8 ) T H E N P 0 SIT10 N 11 y 1.0 ? ? C H R * ( 2 7 ) f C 
H R $ ( B ) ? G 0 T 0 4 6 0 
420 IF B.M27 THEN 450 

4 4 0 P 0 SIT10 N 11 y 1.0 ? ? C H R $ < B ) ? G 0 T 0 4 6 0 
4 5 0 P 0 SIT10 N 5 y 1.7 ? ? " C A N N 0 T E DIT' T H A T 
C H A R A C T E R " ? E ~ 0 ? F 0 R T L.=1. T 0 10 0 ? N E X T T L 

460 POSITION 3 y16 ? ? " 

“ ? F' 0 SIT10 N 5 y 17 t ? “ 

" ? IF E—O THEN 21.0 

470 AS~B ?IF B>31 AND B<96 THEN AS*B~32 
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Listing 3-2. Character Set Editor (continued from page 29) 


1 GOTO 490 


480 

IF B<32 

THEN 

AS- 

:: B + 6 

4 



490 

CP~NCBTAS*8J 

REM 

POSITION 

OF 

CHARAC 

TER 

IN CHARACTER 

SE'1 

f 0 




500 

FOR 0-0 

TO 7 

* C 0 :: 

-PE E 

K (QIC 

P) 1 

REM GET 

THE 0ALOES 

FOR 

THE 

CHARACTE 

R 


510 

CO ( 0 y 0 ) 

- 0 1 IF 

co:; 

> 1 2 7 

THEN 

CO 

( 0 y 0 ) -1 

♦ CO 

-CO-128 







520 

CO ( 1 y 0 ) 

=o: if 

co:: 

>63 

THEN 

C0< 

. 1 . y Q ) . 1 . t 

GV= 

CO-64 







530 

CO(2 y 0) 

-0 i IF 

co:: 

>31 

THEN 

CO ( 

2 y Q ) = 1 i 

CO- 

CO-32 







540 

C 0 ( 3 y Q ) 

-0 1 IF 

co:: 

> 15 

THEN 

co< 

3 y Q)~ 1 $ 


COOO--16 


550 

CO (4 

yQ) 

• ••• 

o: 

IF 

co> 

*7 

/ 

THE 

N 

CO < 4 y 0) 

• •• • 

• ••• 

1 1 C 

0 — C 0 

- 8 













560 

co< 

5 

yQ) 

• ••• 

ot 

IF 

CU> 

3 

THE 

N 

C 0 ( 5 y 0 > 

• ••• 

1 t C 

v-cv 

-4 













570 

C0( 

L.» 

y Q ) 

■ ••• 

• ••• 

01 

IF 

C0> 

i 

I'M E 

N 

CO ( 6 y 0 ) 

• ••• 

• • •• 

1 * c 

0=C0 

-2 













580 

co< 

*7 

/ 

y 0 ) 

• • •• 

• ••• 

co 









590 

NEX 

T 

Q 











600 

X -1 

6 

•> 

❖ (../ •••• 

6 

; I- 

OR 

Q0 

TO 7 

A ■••• 

^ 1 

OR 01 -0 


TO 

7:POSIT 

10 N 

V 

A 

+ Q1 y 

c+q : 

? 

ii H •> 

IF 

CO (01 y 

0 

\ 

) 

1 THEN 

P 

OS I 

T 

10 N 

XT 01 

y 0 

T Q 1 

? 

II II 



610 

NEX 

.... 

01 

•> 

❖ 

NE 

XT 

0 1 L 

0 c 

ATE 

Y 
•• \ 

yCv CHtP 

0 

SIT 

ION 

X y C 


IF 

C 

H < 

12 

8 TH 

EN 

? 

" * 

"t GOTO 

6 

30 


CI-IRt (CM) 1 x-XTi I 


V 

A 


CHRUiCCH) JX-X-l 2 IF X 


620 ? " *" 

630 IF E=1 THEN POSITION 3»16J? "USE A 
R'ROW KEYS TO EDIT" 

640 GOTO 210 
650 POSITION X v 0;? 

>23 THEN X-l 6 
660 GOTO 720 
670 POSITION X v C J ? 

<16 THEN X-23 
680 GOTO 720 

6 9 0 P 0 SIT10 N X y C 1 ? C H R $ ( C H ) t C-C •-1 1 IF C 
<6 THEN 013 

700 GOTO 720 

710 P 0 SIT10 N X v C t ? C H R $ ( C H ) 1 C=0+1 i IF C 
>13 THEN 06 

7 2 0 L 0 C A T E X y C v C H J l :: ' 0 SIT10 N X y C 1 IF C H > 1 
27 THEN ? “*“* GOTO 740 
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730 

740 GOTO 23.0 
750 LOCATE X»C»G23IF 
3C2~C2~ 3.2 8 3 C 0 ( X - 3.6 y C 
7 6 0 C H=3.6 0 3 C 2 - C 2 + 3.2 8 
770 POSITION XvC3? C 
800 POSITION 3 •> 3.6 3 ? 

"iREM CHANGE ME 

810 cv=o:b=128:for o 


:> II \L- II 


C2> 3.28 THEN C 
-■6 ) =0 3 GOTO 770 
♦ CV < X~ 3.6 y C—6 ) ~ 
HR$(C2)3GOTO 2 
"EDIT FINISHED 
S SAG E 

*0 TO 73 FOR Q3. 


H=20 


0 T 


0 7 3 REM CONVERT THE 3. & O'S TO DEC 


820 IF CV ( 01 y 0)™1 THEN CV«CV+B 
830 B ~ B / 2 3 N E X T Q1 3 R E M R E D U C E B F 0 R E A C 
H POSITION 

840 POKE CPTO y CV * REM CHANGE THE BYTE I 
N THE CHARACTER SET 

8 50 C V * 0 i B= 3.2 8 i R E M R E S E T T H E V A RIA B L E S 
FOR NEXT BYTE 

860 NEXT 0 3 REM FINISH THE CHARATER 
8 7 0 C P « N C B J P 0 SIT10 N 3.3. y 3.0 3 ? " " 3 R E T U R N 

:rem reset to clear the character fro 

M SCREEN 


3.640 NAM$ 


POSITION 3 y 


161? "EN T ER N A ME F0R FILE"y3 IN P U T NAM E 
$3 IF NAME$~"" THEN 200 

1650 NAM$ (1 r 2 ) = * D 3 " 3 NAM $ < 3 t .3.0 ) ~ NAM E $ 3 N 
AM$(11y14“.CHB“3 REM CODE FILE F0R CH 
ARACTER BASE 

1660 TRAP 17403 OPEN #2v8 r 0 r NAM$3 FOR Q = 
NCB TO NCB+10233 CV=PEEK(0)3 REM 0ET THE 
VALUES FOR THE CHARACTER SET 
1670 PUT #2 v CV 3 NEXT 0 3 REM PUT THE VALU 
ES ONTO DISK 
1680 CLOSE #23 GOTO 200 

1690 NAM$ : = : " “3 POSITION 3 r 

16 3? ”ENTER NAME F0R FILE"5 3 INPUT NAME 
$3 IF NAME$~"“ THEN 200 

1700 NAM$(1y 2) = "D 3"3NAM?(3)-NAME$3 NAM$ 
( LEN (NAME* ) +3 ) •- ” ♦ CHB " 3 REM C0DE FILE F0 
R CHARACTER BASE 

3.73.0 TRAP 3.740 3 OPEN -ft2 * 4 v 0 y NAM$ 3 FOR Q : = 
NCB TO NCB+1023 3 GET #2e CV 3 REM GET THE 
VALUES FOR THE CHARACTER SET 
1720 POKE 0 9 CV 3 NEXT 0 3 REM PUT THE VALU 
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Listing 3-2. Character Set Editor (continued from page 31) 


ES ONTO DISK 
1730 CLOSE #2{GOTO 200 
17 4 0 E R * P E E K < 19 5 ) i C L 0 S E # 2 { R E M G E T T H E 
ERROR NUMBER X CLOSE FILE 
1750 IF ER«170 THEN POSITION 3 y 1 6 {? " F 


ILE NOT FOUND "{GOTO 18 

00{REM GIVE ERROR MESSAGE 
1760 IF ER-162 THEN POSITION 3vl6{? "D 
ISK FULL "{GOTO IS 

00 

1770 IF EE-169 THEN POSITION 3f16{? "D 
IRECTORY FULL - GET NEW DISK "{GOTO 18 
00 

1780 POSITION 3 y16{? "WE'VE GOT A PROB 
LEM 

1800 FOR X«1 TO 100{NEXT XJGOTO 200 


Line 50 is the data needed to draw the box on the screen to show what letter/character is 
being edited. Be sure that this data line is entered exactly as follows: an exclamation point, a 
space cntrl-Q cntrl-R cntrl-C, space shift-equals space shift-equals, space cntrl-Z cntrl-R cntrl-Z, 
space EDIT, LETTER. 

Lines 60-70 set the graphics mode to 0, erase the cursor, and print the control codes on the 
screen. 

Lines 80-90 print the grid and box on the screen. Use the cntrl-T to make the 8x8 grid. 

Line 100 finds the end of memory and calculates the address that would be 2K before the end 
of memory. This leaves IK for the character set and IK for the screen display and display list. 

Line 110 pokes the new character set address and the old character set address into RAM. 
These two values will be used in the machine language subroutine that moves the character set 
from ROM into RAM. 

Line 120 contains the machine language subroutine to move the character set from ROM into 
RAM. Pl$ must be exact if the routine is to work correctly. The data for the subroutine is in line 
125. Be sure that these numbers are entered correctly. If they are not, the program will crash. 

Line 130 uses the USR function to call the machine language subroutine. The Q is a dummy 
variable. 

Line 140 changes the address of location 756 from the character set in ROM to the character 
set in RAM. 

Lines 150-180 print the entire character set on the screen. In order to print some codes, the 
escape key must be entered first. When we are printing characters using the CHR$ command, we 
can issue an escape code by printing CHR$(27) just before the character. In this way we can 
display all the characters in the character set. 

Line 190 opens the keyboard for reading. When editing the character set, we will use only 
one key stroke commands. 
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Line 200 prints the prompt under the square and grid. There are 15 spaces after the T to clear 
out any previous message. We will be returning to this line after several of the subroutines in this 
program. The variable E will be our flag to let the computer know whether or not we are editing a 
character. When it is set to 0, we can use the control codes to begin an edit, load a character set, 
save a character set, or quit. When the E is set to 1, we can stop an edit or edit a character using 
the arrow keys. The variable X is the row that the cursor is in on the screen, and C is the column. 

Line 210 gets the keystroke from the keyboard and checks it for a control-E. If it is a 
control-E and we are not in the edit mode, the variable E will change to 1 and the program will go 
to line 400. 

Line 220 checks the variable B for a control-S. If the program is in the edit mode, and the 
control-S is pressed, the program will leave the edit mode and go to the routines that will restore 
the grid and erase the character in the box. The variable E is also reset to 0. 

Line 230 checks for a control-D. When a control-D is pressed and the program is not in the 
edit mode, the program will save the character set displayed on the screen. This program stores 
the character set to disk. It can be changed to store the characters to cassette by opening the 
cassette instead of the disk. You do not need a name for the file if you are using a cassette. 

Line 240 will end the program when a control-Q is pressed. Before ending, the program will 
restore the ROM character set, restore the cursor, and clear the screen. Whenever an alternate 
character set is used in a program, it is good programming practice to reset the pointer to the 
ROM character set. Loading a new program with an alternate character set could confuse the next 
user. 

Line 250 will direct the program to the routine that loads a new character set from disk or 
cassette when a control-L is pressed. 

Lines 270-310 will direct the program to the lines that alter the character set when the 
variable E is set to 1 and an arrow key or space bar is pressed. 

Line 320 will loop back to line 210 if the key pressed is not one of the control keys used in this 
program. 

Line 400 begins the edit mode. The prompt under the grid is changed and the program waits 
for a key to be pressed. 

Lines 410-460 check the key that has been pressed. If it is one of the screen function keys, 
clear screen, line up or down, etc., the program will not allow it to be edited, and will print a 
message to that effect on the screen. If it is a character that can be edited, it will be printed in the 
box on the screen. 

Lines 470-480 check the value of B and store the actual location in the character set in 
variable AS. B is stored in AS before it is checked. There is no else command in ATARI BASIC, so 
we will store the actual value of B in AS. If it is not a character whose location needs to be 
changed, AS will be set correctly. If the ATASCII value of the key pressed is greater than 31 and 
less than 96, that is any key other than a graphics character or lowercase letter, the program will 
subtract 32 from B and store it in AS. These are the characters that have been moved up in the 
actual character set. If the value of B is less than 32, a graphics character has been entered and the 
program adds 64 to the value of B and stores it in AS. Remember that the graphics characters are 
located between the uppercase letters and the lowercase letters in the actual character set. 

Line 490 calculates the position of the first byte of the character in the character set. The 
position of the character that is stored in AS is multiplied by 8 (each character uses 8 bytes) and 
this value is added to the location of the character set. The variable CP contains the location of the 
first byte of the character that will be edited. 
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Lines 500-590 convert the decimal value of each byte into a binary value. Each bit is stored in 
the array CV. This routine is similar to the routine used in Chapter 1. It takes the decimal value of 
the byte and compares it to 127. If the number is greater than 127, then the first bit is a one. The 
program subtracts 128 from the value in CV. The next line checks the remaining value to see if the 
next bit should be set. Each line continues to check the value of CV against the value of that bit 
less one. We use one less than the actual bit value because if that bit were set, and we subtracted 
the bit value, the remainder would be zero. There would be no indication that we should get that 
bit unless the decimal number was larger than the bit value. By using the bit value less one, we 
will get a remainder of one if the decimal value is equal to or larger than that place value. Every 
time the program sets a bit to one, it subtracts the value of that place or bit from the decimal value 
of the byte. This routine is repeated 8 times; once for each byte that makes up the character set. 

Lines 600-620 reset the row and column values for the 8x8 grid and using the values in the 
array CV, draws the character onto the grid. A control-T is printed. Then the value of CV is 
checked for a 1. If that element of the array does contain a 1, an inverse-video cursor will be 
printed. Once the entire character has been drawn, the program will use the locate command to 
find out what has been printed in the upper left corner of the grid. The ATASCII value of this 
character will be stored in the variable CH. The asterisk will be our cursor while editing. If the 
character in the upper left corner is in inverse-video, an inverse-video asterisk will be printed 
there. 

Line 630 checks E to see if we are, in fact, in the editing mode. If we are, it prints the prompt 
on the screen. This routine then goes back to line 210. 

Lines 650-740 move the asterisk cursor in the grid. The character that is stored in CH is 
printed in the grid where the asterisk is. If we are moving the asterisk to the right (line 650), the 
variable X is incremented. If we are moving it to the left (line 670), X is decremented. Moving the 
asterisk up (line 690) decrements C and moving it down (line 710) increments C. After the 
variable X or C is changed, the program checks it to make sure that it is not beyond the grid area. If 
it is, the variable is reset to the other side of the grid, giving it a wrap-around feature. Once X or C 
are correctly set, the program gets the ATASCII value of the character that the asterisk will be 
replacing and stores it in CH. Once again, if the character was in normal text, an asterisk will be 
printed. If the character was an inverse-video cursor, an inverse-video asterisk will be printed. 

Lines 750-770 change the character in the grid from a ball (cntrl-T) to an inverse-video 
cursor and back again. When the space bar is pressed, and the program is in the edit mode, it will 
be directed to this routine. The locate command gets the ATASCII value of the cursor. If it is in 
inverse-video, then the value of the character that was there will be changed to 20 (cntrl-T), and 
the asterisk will be reprinted in normal video. Otherwise, the character that was there will be 
changed to the inverse-video cursor value, and the asterisk will be printed in inverse-video. When 
the value of CH is changed to 160, indicating that we are setting that bit, the value in the array CV 
is changed to 1 for the corresponding bit. When we erase a bit from the screen, the value of the 
corresponding bit is changed back to 0. 

Lines 800-870 are used when we are satisfied with the new character that we have just 
created. The new prompt is printed on the screen, and the values stored in the array CV are 
converted into decimal. This procedure is simpler than the convert from decimal to binary 
routine. The variable CV is cleared. This variable contains the decimal value of the character. The 
variable B is set to 128 - the bit value of the most significant bit in the byte. If the leftmost bit is set 
to one, this value will be added to CV. Since each bit is half the value of the preceding bit in a 
byte, we divide B by 2 each time we check the next element of the array. Each time an element 
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contains a 1, we add the value of B to CV. After we have checked each of the 8 elements of the 
array that represent the byte, we will have the decimal value of that byte. That value will be poked 
into the position of that byte in the character set in RAM. The variables CV and B are reset after 
each byte. Once the entire character has been moved into the character set, it is removed from the 
box on the screen and the routine returns to the main part of the program. Since the entire 
character set is displayed on the screen and it is being used for the prompts as well, it would not be 
wise to change the uppercase letters or the characters that are being used in the editing modes, 
especially the control-T, unless absolutely necessary. 

Lines 1640-1680 save the character set that we edited to disk. The string variable NAM$ is 
cleared of the last entry, or garbage that the string contains from the previous program. The name 
that you want to call this set is placed in NAME$. If you press the return key without entering a 
name, the program will return to the menu. All good programs have an abort code that returns you 
to the menu should you enter a routine by mistake. When you enter the name of the character set, 
you do not have to enter the D: before the name. 

Line 1650 takes the name that you enter and adds the D: before the name. It also appends the 
name with .CHB. This will separate the character sets from any other programs or files on the 
disk. The program then opens the file and, using the peek command gets every byte of the 
character set, and puts in on the disk. When the entire set has been stored on disk, the file is 
closed. There is a trap set before the file is opened. If the disk or the directory is full, it will be 
reported on the screen. 

Lines 1690-1730 get the character sets that we previously stored on the disk. The string 
variable NAM$ is cleared, and the program asks for the name of the character set that you would 
like to bring in. If you press the return key without entering a name, the program will return to the 
main menu. Once again, the program will add the D: to the beginning of the character set name, 
and .CHB to the end of the name. The trap is set, and the program will bring in the character set. 
This routine can be used in any program to bring in a character set that is stored on disk. Instead of 
having the program ask for the name of the character set, you could specify it in the program lines. 
This way, any character set that is designed with this program can be used with any other 
program. Once the character set has been read in, the program will close the file and return to the 
menu. 

Lines 1740-1800 trap the disk errors. The error number is stored in decimal location 195. By 
peeking at this location, we can get the number of the error. If the file was not found, the disk is 
full, or the directory is full, this message will appear on the screen. If any other error caused the 
program to go to this routine, We’ve got a problem will be printed on the screen. Normally, 
every possible error is tested for, but in this case, the error could be 144, which could be the 
result of anything from a bad disk to the disk door being left open. In this program, we'll let the 
user know that something has gone wrong, and then return to the menu. 

The character sets created with this program can be used in any program that requires a 
different character set. It can be used in text mode or the colored text modes. If you have a 
cassette recorder, change the following lines. 

70 change the word disk to cassette 

1640 delete the INPUTs 

1650 delete 

1660 change the OPEN command to OPEN #7,8,0,“C:” 
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1680 CLOSE #7 

1690 delete the INPUT 

1700 delete 

1710 change the OPEN command to OPEN #7,4,0,“C:” 

1730 CLOSE #7 

Lines 1740-1800 can be deleted or changed for cassette errors: error 143 and error 138. 

When using the new character set in another program, calculate the location of the new 
character set. This will be the first location that the first byte of the character set will be poked in. 
Always begin the new character set at least IK before the display list and the screen display. 

THE INVISIBLE MODES 

In the last chapter, we looked at all the modes that are available on the ATARI. Some of these 
modes are available in BASIC, others can only be accessed by changing the display list. Using the 
character editor in this chapter, we could reconstruct the lowercase letters for ANTIC 3, save 
them to disk, then read them in for the program. We would not have to move the character set 
from ROM. We would have our new set on disk. 

Two other modes between graphics mode 0 and graphics mode 1 are ANTIC 4 and ANTIC 5. 
Both of these modes are text modes, but they support multicolored characters. Each character in 
these modes is eight pixels wide, but the pixels are turned on or off in pairs. The net effect is that 
the character is four bits wide. 

The color of the character is determined by the bit combination of every pair of bits in the 
byte. Look at Fig. 3-2. The first bit pair is 11. The pixels that would be turned on for this part of the 
character would be in the color set by color register 3 (peek 711). The second pair of bits, 01, will 
be the color of color register 1 (peek 709). The third bit combination, 10, will be the color of color 
register 2 (peek 710). The last bit combination is 00. This is the background color, the color of 
register 0 (peek 708). 

The characters designed using these modes can be one color, or several colors. In the 
following program, we will design a screen that uses ANTIC mode 4. It gives the illusion of being 
graphics mode 7 without the memory consumption. 

This type of program is called a simulation. It simulates a simple circuit. When the circuit is 
complete, the light will light; when it is broken, the light will go out. The bottom of the light and 
the wire is the same character. The top of the battery and the wire is also the same character. By 
using two different bit patterns in each of these characters, we can create a two-color character. 
By using three different bit patterns, we could create a three-color character. 
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Listing 3-3. Multicolor Characters 


.10 REM LISTING 3*3 

20 REM ANTIC 4 - MULTICOLOR CHARACTERS 
30 REM BY L * M♦ SCHREIBER FOR TAB BOOKS 
40 DIM PI*(20) 

50 A-PEEK(106)-8 t N CB=A *256JREM PLA C E N 
EW CHARACTER SET 2K BEFORE END OF MEMO 
RY 

60 POKE 204 yA * POKE 206y224 l REM STORE T 
HE NEW CHARACTER SET ADDRESS AND THE R 
OM ADDRESS 

70 FOR X ~ .1. TO 20 i READ BiPl*<XyX)=CHR*< 
B) i NE XT X t R EM MA CHIN E L A N 6U A GE SUBR 0UT 
INE TO MOOE CHARACTER SET 
75 DATA 104y162 y4 y160y0 t 177 r 205 v145y20 
3 r 200 t 208 y 249 y 230 r 206 y 230 y 204 y 202 y 208 y 
242y96 

8 0 Q=IJ S R ( A D R ( P1 * ) ) J ? " > C L E A R > " l R E M USE 
MACHINE LANGUAGE PROGRAM WITH THE USE 
FUNCTION 

9 0 D LIS T - P E E K < 5 6 0 ) + P E E K < 5 61 ) * 2 56 t R E M (3 
ET THE LOCATION OF THE DISPLAY LIST 
100 POKE DLIST f 3 y 68 5 REM CHANGE THE FIR 
ST LINE TO ANTIC 4 


1 1 0 
RAP! 
12 0 
TO 
130 
140 
1 5 0 
16 0 
170 
180 
190 
200 


FOR X=DLIST+6 TO DLIST+28JREM IN G 
ICS 0 THE DLIST IS 32 BYTES LONG 
POKE X y 4♦REM CHANGE ALL THEN LINES 
ANTIC 4 
NEXT X 

REM CONTROL A - UPPER LEFT CORNER 
D A I A 8 5 y 6 4 y 6 4 y 6 4 y 6 4 y 6 4 y 6 4 y 6 4 
REM CONTROL B - TOP LINE 
DA I A 85y 0y 0y 0 y 0 y 0y 0 y 0 

REM CONTROL. C - TOP OF BATTERY 
D A T A 81 y 1 7 y .1.7 y 17 y 17 0 y 17 0 y 1 7 0 r 17 0 
REM CONTROL D •••• UPPER RIGHT CORNER 


220 

230 

240 

250 

260 

270 

280 


DATA 85 y 1 .» 1 y 1 y 1 y 1 i 1 y 1 

REM CONTROL E •••• LOWER RIGHT CORNER 

DATA 1 y 1.» 1 y 1 y 1 y 1 y 1 y 85 

REM CONTROL F - BOTTOM LINE 

D A T A 0 y 0 y 0 y 0 y 0 y 0 y 0 y 8 5 

REM CONTROL G - BOTTOM OF BULB 

DATA 51y 51y 51y 51y12 y12 y12 y85 

REM CONTROL H - BOTTOM LEFT CORNER 
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Listing 3-3. Multicolor Characters (continued from page 37) 

2 9 0 .0 A T A 6 4 y 6 4 v 6 4 v 6 4 y 6 4 y 64 y 6 4 y 8 5 
300 REM CONTROL I •- LEVER UP 

3 :l. 0 D A T A 0 y 0 y 0 y 2 y 8 y 3 2 y 12 8 y 0 

320 REM CONTROL J LEVER PARTWAY DOWN 

3 30 D A T A 0 y 0» 0 y 0 y 10 y 3 2 y 12 8 y 0 

340 REM CONTROL K - LEVER NEARLY DOWN 

3 6 0 D A T A 0 * 0 y 0 1 0 1 0 1 10 1 16 0 r 0 
370 REM CONTROL L - RIGHT SIDE 

380 D A I A 64 y 64 y 64 y 64 y 64 y 64 y 64 y 64 

390 REM CONTROL. M - LEFT SIDE 

400 DATA 1 y 1 y 1 y I y I y :l y 1 y 1 

410 REM CONTROL N - LEVER DOWN 

420 DATA 0 y 0 y 0 y 0 y 0 y 0 y 0 y170 

430 REM CONTROL 0 - BATTERY BOTTOM 

4 4 0 D A T A 17 0 y 1 7 0 y .1.7 0 t .1.7 0 y 17 0 1 17 0 r .1.7 0 r 1 
70 

450 REM CONTROL P - BULB TOP 

4 6 0 D A T A 0 y 0 y 0 y 0 y 1 2 y 51 y 51 y 51 

470 FOR X=NCB+65*8 TO NCBi81. 1 8-1 S REM F 
IRST BYTE OF CONTROL A 

480 READ B* POKE X y B £ NEXT X £ REM REDESIG 
N CONTROL CHARACTERS 

490 POKE 756y A £ REM USE THE NEW CHARACT 
ER SET 

5 0 0 P 0 SIT10 N .1.5 y 10 £ Y " > A B B B C B B D > " £ P 0 SI 

T10 N 15 y 11 £ ? * > |.„ > > 0 > '*• M " 4 " «■ 

15yl2£? " >L> >P> >M> " 

5 :l. 0 p 0 s IT10 N 15 y 13 £ ? ■ > H FIF F G F E > " 

5 2 0 T L =3 0 £ G 0 S U B 6 0 0 £ 7 L=5 


,n ; POSITION 


530 POSITION 


17y13£? ">J>"£ 
SWITCH DOWN 
17 y 13 £ ? " >K> 11 £ 


EM BRING THE 
540 POSITION 
550 POSITION 
£ POKE 710y15 
560 TL-30 £ GOSI.JB 600 £ TI 
570 POSITION 17y13, 
GOSUB 610 
580 POSITION 
590 POSITION 


GOSUB 610£R 


GOSUB 610 


1.7 y 13 £ ? " > N :>• * 5 C=P E E K ( 710 ) 




? ti i 7. ♦ 'j> » }. js; y » ♦ 


17 y 13 £ ? 


" >J>"£ 


POKE 710 y C £ 


GOSUB 610 


•>!>'£GOTO 520 


17 y 13 £ ? 

600 IF PEEK(53279)06 THEN 600 

610 POKE 77 y 0 £ FOR T«1 TO TL£ NEXT T £ RET 

URN 


Line 40 sets Pl$ for 20 characters. The machine language subroutine to move the character 
set from ROM into RAM will be placed in this string. 
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Table 3-2. Machine Language Listing to Move Character Set From ROM to RAM. 
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Table 3-2. Machine Language Listing to Move Character Set From ROM to RAM (continued from page 39). 


2 () () 

1N Y 


I ii c r 0 iyi 0 r*i t 

t i"i 0 

:i. l"i d 0 ;•( Y <• 

•** i y\ f***i 

\J o 

BNE 

ji 

B r s r i c h :i. T 

b i'i 0 

:i.rid 0 x Y is 

•“) /| 

* * *f* ,•* 


r 

Ci |. O hijir-k c 
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Line 50 subtracts 8 from the number of pages of RAM in your system. This is 2K of memory. 
IK is set aside for the screen and display list. The other IK is for the character set. We will move 
it just before the display list. The variable NCB will contain the decimal location of the new 
character base. 

Line 60 stores the location of the new character base and the ROM character base in two 
temporary locations. These locations will be used by the machine language subroutine. 

Line 70 contains the machine language subroutine. The data for the machine language 
subroutine is in line 75. Be sure that all the numbers are entered correctly. 

Line 80 uses the USR command to execute the machine language subroutine. See Table 3-2 
for the assembly language listing of this routine. 

Line 90 calculates the beginning address of the display list by multiplying the value of 
decimal location 561 by 256 and adding it to 560. The address of the display list is always a 2-byte 
figure. 

Lines 100-130 change the display list from graphics mode 0 (ANTIC 2) to ANTIC 4. The first 
line of the screen is combined with a command that tells the CTIA where the first memory 
location of screen data is. To change this line to ANTIC 4, you must add 3 to the first address of the 
display list and poke this memory location with 68. Since ANTIC 4 uses the same number of lines 
on the screen as graphics mode 0, we know that there are 23 more locations to change from 2 to 4. 
By adding 6 to 28 to the address of the display list, we can change the entire screen from graphics 
mode 0 to ANTIC 4. 

Lines 140-460 contain the data to change the standard graphics characters to the ones that 






41 


































































































will be used in this program. Each character can be one, two, or three colors depending on which 
bits are set in each byte. See Fig. 3-3 for a detailed description of each character. 

Lines 470-480 read the bytes for each character and poke them into the correct locations. 

Line 490 changes the character set used from the one in ROM to the modified one in RAM. 

Lines 500-510 print the diagram on the screen. Each letter in the quotation marks should be 
entered as a graphics character. Use the control key to enter these characters into the program. 

Lines 520-610 make up the body of the program. The variable TL is set to 30. This value will 
be used in the timing loop. The program goes to the subroutine in line 600. Here it waits for the 
start key to be pressed. The program will continue to loop until the start key is pressed. Once it is 
pressed, the program will reset the attract mode, and enter the timing loop in line 610. This 
timing loop is needed to smooth the program. Without it, the computer would read that the start 
key was pressed before you had a chance to take your finger off the key. After the timing loop, the 
program returns to the line that it came from. The variable TL is reset to 5, and the program will 
lower or raise the lever. Again, be sure that each letter in the quotation marks is entered as a 
graphics character. We will use the timing loop after each time the lever is drawn. If the lever is 
being lowered, the light will glow once the connection has been made. If the lever is being raised, 
the light will go out as soon as the connection is broken. 
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ANTIC 5 could use the character set that we created in this program. The characters, 
however, would be 16 scan lines tall instead of the 8 in ANTIC 4. The display list would be 
shortened by 12 bytes. The characters drawn with ANTIC 5 would appear to be in graphics mode 
5. Again, we can obtain higher resolution graphics without using large amounts of computer 
memory. 
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Chapter 4 

Principles 
of Animation 


Good use of graphics will enhance any program. But graphics alone are like cake without icing. We 
all prefer movies to snapshots. Movies, cartoons, television, and most other forms of entertain¬ 
ment rely heavily on movement along with color, sound, and pictures. 

In real life, people, animals, and objects move with a particular rhythm. Any movement that 
differs from the norm appears unnatural and artificial. Artists try to imitate the natural move¬ 
ments of their characters when they create cartoons. Hundreds of drawings make up one feature 
length film. Each drawing is slightly different than the last, so that when they are run together, the 
characters move smoothly across the screen. 

Using animation in programs is not difficult, but it does take extra planning to create 
believable characters that move gracefully on the screen. 

CHARACTERS WITH A PURPOSE 

If we had a computer with block graphics, and no way to redefine the character set, we could 
make a few stick figures and leave the rest to the user's imagination. But, we don’t. We can change 
the characters to create believable figures and characters. We can alter parts of the character so 
that when it is printed on the screen, we have true animation. 

Good graphics and good animation does not come easily. Each character that is drawn on the 
screen must be carefully thought out. We have several different graphic modes available to us. 
Before designing the character set, we must decide what type of program we are designing, how 
much animation or movement will be involved, and how the screen will be laid out for good color 
and movement. 

Once we have decided on the type of program, we can begin to design the characters. By 
using graph paper, we can set a good idea of what the character will look like on the screen. 

The first program that follows uses a very simple form of animation. As the keys 1-8 are 
pressed, a note floats up from the corresponding pipe and a tone sounds. The note does not appear 
all at once. Figure 4-1 shows the parts of the note that appear on the screen. Once the entire note 
is on the screen, it floats to the top of the screen. Four more characters are used to give the 
illusion of movement on the screen. When the note reaches the top, it does not disappear from the 
screen all at once. One row of the note is removed at a time until the entire note is gone. As you 
can see from the drawings, several characters had to be redefined to give the notes the different 
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forms that they need. Each note is just slightly different than the others. This keeps the 
movement of the notes smooth as they appear and disappear. If the notes were drastically 
different, their movement would be choppy and artificial looking. 


Listing 4-1. Simple Animation 


:lO REM LISTING 4*1 
20 REM SIMPLE ANIMATION 

30 REM BY L,M. SOHREIBER 


FOR TAB BOOKS 
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40 DIM NTE$(8) yP1 $(20) 

5 0 A ~ P E E K < 10 6 ) - 8 J C B=A * 2 5 6 J R E M P L A C E C H 
ARACTER SET 2K BEFORE END OF MEMORY 
60 POKE 204 y A t POKE 206 y 224 ♦ REM STORE T 
HE NEW CHARACTER SET ADDRESS AND THE R 
OM ADDRESS 

70 FOR X-l TO 20 1 READ BJP1«(X»X)=CHR*< 
B ) J N E X T X J R E M M A C HIN E I... A N G U A G E S U B R 0 U T 

INE TO MOVE CHARACTER SET 

7 5 D A T A 10 4 y 16 2 y 4 y 16 0 y 0 y 17 7 y 2 0 5 y 14 5 y 2 0 

3 y 2 0 0 y 2 0 8 y 2 4 9 y 2 30 y 2 0 6 y 230 y 2 0 4 y 2 0 2 y 20 8 r 
242y96 

8 0 « - U S R ( A D R ( P1 $ ) > 5 R E M U S E M A C HIN E L A N 
GOAGE PROGRAM WITH THE USR FUNCTION 

90 FOR X : "8 TO 175 J READ C 5 POKE CB+XfCJN 
EXT X 

10 0 D A T A 8 y 1.2 y 10 y 8 y 8 y 10 4 y 2 4 8 y 9 6 
110 D A T A 4 y 6 y 5 y 9 y 8 y 1 0 4 y 2 4 8 y 9 6 
120 DATA 0 y 2 y 3 y 5 y9 y106 r 124 r 48 
13 0 D A T A 8 y 12 y 10 y 8 y 4 y 5 2 y 12 4 y 4 8 

1 4 0 D A T A 112 y J. 9 2 y 3 2 t 16 y 8 y 4 8 y 1.12 r 9 6 

15 0 D A')" A 12 y 10 y 8 y 8 y 10 4 y 2 4 8 y 9 6 y 0 

16 0 D A IA 10 y 8 y 8 t 10 4 y 2 4 8 y 9 6 y 0 » 0 

17 0 D A T A 8 y 8 y 10 4 y 2 4 8 y 9 6 y 0 y 0 y 0 

18 0 D A T A 8 y 10 4 y 2 4 8 y 9 6 y 0 y 0 y 0 y 0 

19 0 D A f A J. 0 4 y 2 4 8 y 9 6 y 0 y 0 y 0 y 0 y 0 

2 0 0 D A T A 2 4 8 y 9 6 y 0 .» 0 y 0 y 0 y 0 y 0 
2.1.0 D A T A 9 6 y 0 y 0 1 0 t 0 y 0 y 0 r 0 

2 2 0 D A T A 0 y 0 y 0 y 0 y 0 y 0 y 0 y 8 

2 3 0 D A T A 0 y 0 » 0 y 0 y 0 y 0 y 8 y 12 

240 D A TA 0y 0 y 0 y 0 y0 y8y12 y10 

2 5 0 D A T A 0 y 0 y 0 y 0 y 8 y 1 2 y 10 y 8 

2 6 0 D A T A 0 y 0 y 0 y 8 y 12 y 1 O y 8 y 8 

2 7 0 D A T A 0 y 0 y 8 y 12 y 10 y 8 y 8 y 10 4 

2 8 0 D A T A 0 y 8 y 12 y 10 y 8 y 8 y 10 4 y 2 4 8 

290 DATA 255y255y255 t 255y255y255 y255y2 

55 

300 D A T A 2 5 5 y 2 5 5 y .1.9 5 y .1.9 5 y 2 5 5 y 2 5 5 y 2 5 5 y 2 
55 

340 GRAPHICS 17JREM USE LARGE COLOR TE 
XT MODE 

350 POKE 756y A J REM NOW WE CAN USE THE 
SET IN RAM 

360 R2~9♦FOR R=10 TO 20JFOR X=2 TO 16 
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Listing 4-1. Simple Animation (continued from page 49) 


STEP 21POSITION XyRIREM HAKE THE PIPES 
370 IF R X < > R 2 T H E N ? # 6 5 " 4 " 1 G 0 T 0 3 90 1 
REM MAKE THE PIPE SOLID 

3 80 ? # 6 5 " 5" 1 R 2 - R 2 -11R E M M A K E T H E AIR 
HOLE 

390 NEXT X 1 NEXT R 

400 N T E$ ~" yI'CQH(? <" 1R EM CHA R A C TER 0F T 
H E N 0 T E S ~ y 1 c| :i. a m o n d 1 e f i - b r a c k e t Q H (? < 

410 0 P E N # 4 y 4 , 0 1 - " K 1 " 1 R E H 0 P E N T H E K E Y B 
CARD FOR A READ 

420 POKE 764 r 2551 GET *4 r Cl IF 0127 THE 
N C~C~12G 1POKE 694 y 01 REM GET THE KEY P 
RESSEB 

4 30 IF C<49 OR 056 THEN 4201 REM NOT A 
NUMBER 

440 CLOSE #41 REM GOT THE NOTE 
450 00481 REM PLACE OF NOTE 
460 X~C*21 R-”9 1 REM COLUMN FOR THE NOTE 
ON THE SCREEN 

470 S0UN D 0v A SC(NTE$(CyC)) r 10 r 101REM S 
OLJND OF THE NOTE 

480 FOR Rl = l TO 71 POSITION XyRI? #6 y CH 
R $(44+R1) 1R E M P RIN T P A R T 0 F T H E N 0 T E 
490 GOSUB 8001 REM TIMER ROUTINE 
500 NEXT Rl1 REM GET THE WHOLE NOTE OUT 
510 P 0 SIT10 N X y R 1 ? # 6 } " ! " 1 G 0 S U B 8 0 0 1 X 2 
-X1R2~RIR1~R1 REM LAST POSITION OF NOTE 
520 FOR R-Rl TO 0 STEP -11 REM MOVE UP 
THE SCREEN 

5 3 0 X1 ~ IN T ( R N D ( 0 ) T 2 ) 1 X1 - X+X11 R E M U S E 0 
NE OF TWO POSITIONS 

5 4 0 N=IN T ( R N D ( 0 ) * 5) 1 N=3 3+N 1R E M G E T A N 
OTE DISPLAY 

5 5 0 P 0 SIT10 N X1 y R 1 ? # 6 y C H R $ ( N ) 1 R E M P R I 
NT THE NOTE 

5 6 0 P 0 SIT10 N X 2 .* R 21 ? # 6 5 “ "1X 2 ~ X1 1 R 2 :::: R 
1GOSUB 8001 REM ERASE THE LAST NOTE 8 R 
EMEMBER THIS ONE 

570 NEXT R1 REM ALL THE WAY UP THE SORE 
EN 

5 8 0 P 0 SIT10 N X1 y 0 1 ? # 6 i " ! " 1 R E M RIG H T T 
HE NOTE 

590 FOR R-0 TO 61 POSITION XIvOI? #6 y CH 
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R * ( 3 8 + R ) t G 0 S U B 8 0 0 t R E M M A K E T H E N 0 T E D 
ISAPPEAR 

600 NEXT R 

6 10 P 0 SIT10 N X1 9 0 t ? # 6 v " " i R E M E E A S E I 

T 

620 SOUND 0 v 0 v 0 v 0 £ RI::.M TURN OFF THE SOU 
ND 

630 GOTO 410 
640 END 

300 FOR T = 1 TO 10iNEXT TiRETURN 


Line 40 dimensions two strings. NTE$ will contain the characters whose ATASCII values 
represent the tones C-C. Pl$ will contain the machine language subroutine to move the character 
set from ROM to RAM. 

Line 50 subtracts 2K from the amount of RAM in the computer. The decimal address of the 
first location of the character set in RAM is stored in CB. 

Line 60 pokes the high order address of the memory location of the RAM character set into 
204 and the location of the ROM character set in 206. These addresses will be used in the machine 
language subroutine that moves the character set from ROM into RAM. 

Line 70 places the machine language subroutine into Pl$. The data is read from line 75 and 
placed in Pl$. Be sure that the numbers in the data line are correct. 

Line 80 calls the machine language subroutine. 

Line 90 reads the data from lines 100-300 and replaces the characters in the character set 
from the exclamation point to number five. The variable X is first set to 8. The first 8 locations in 
the character set (0-7) contain the data for the space. If the information is changed, the screen will 
not be clear. By adding the value of X to CB, we will change the next 21 characters after the space. 

Line 340 begins the program. The graphics mode is set to 17—large color print with no text 
window. 

Line 350 pokes 756 with the value of A. The variable A contains the high order address of the 
RAM based character set. By poking this location, you can change the character set. 

Lines 360-390 draw the pipes on the screen. To place the air hole in the correct position in 
each pipe, R2 is set to 9. When the difference between the pipe’s row and its column is equal to R2, 
the air hole will be drawn instead of the solid pipe. After the air hole is drawn, R2 is decreased by 
1. Each air hole will therefore be slightly lower than the previous one. 

Line 400 places one character for each note into NTE$. Be sure that this line is entered 
correctly, or you will hear some strange tones. It is—yl control period left bracket QH@< 

Line 410 opens the keyboard with the read command. 

Line 420 clears location 764. By setting it to 255, you guarantee that the next key pressed 
will be the tone that you want. If you didn’t clear it, the last key pressed would be stored in that 
location. It could be a key that you pressed by accident. Now the program will wait until a key is 
pressed. The ATASCII value of the key will be stored in the variable C. If the value of C is greater 
than 127, it means that the inverse key was accidentally pressed. The program subtracts 128 from 
the value of C to get the correct value of the key pressed. By poking location 694 with a 0, the 
inverse flag is reset. The next key pressed will have a value less than 128. 
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Line 430 checks the value of C to make sure that it is a number between 1 and 8. If it is not, 
the program goes back to line 420 to wait for another key value. 

Line 440 closes the keyboard. 

Line 450 calculates the key that was pressed. Since the AT ASCII value of 1 is 49, we can set 
the correct value of the number keys by subtracting 48 from C. 

Line 460 calculates the column of the pipe that the note will appear above. The pipes are all 2 
columns apart. The value of C is multiplied by 2. R is the row that the note will be printed in. 

Line 470 turns on the sound. We use the ASCII of the character located in position C of 
NTE$. Remember, C is the key pressed. If a 2 was pressed, the tone would be the ASCII value of a 
lowercase 1. This value corresponds to the tone of D. 

Lines 480-500 print the note above the correct pipe. Each time the note is printed, it is the 
next note in the sequence of characters that make up the notes. First the tip of the note shows, 
then a little of the stem, etc., until the entire note appears on the screen. The characters used for 
the notes come one after another in the character set. By adding the value of R1 to 44 (the 
character just before the first note), we can print the entire sequence of notes easily. 

Line 510 prints the entire note above the correct pipe. The position of this note is stored in 
the variables X2, R2, and Rl. These locations will be used in the next routine. 

Lines 520-570 give the illusion that the note is floating to the top of the screen. Each note is 
printed either in the same column as the pipe, or one column to the right of the pipe. Line 530 
chooses either a 0 or a 1. Add this value to the value of the pipe column (X) in order to calculate the 
column for the next image of the note. Line 540 chooses one of the five variations that the note can 
have. The value of N is added to 33 to arrive at the note that will be printed. Line 550 prints the 
chosen note in the correct column and row. The last note is erased, and the values of the new note 
are stored in X2 and R2. 

Line 580 prints the note one last time before it begins to disappear off the top of the screen. 

Lines 590-600 erase the note slowly from the screen. This time the characters that make the 
note disappear one row at a time will be used. These characters are also placed sequentially in the 
character set. By adding the value of R to 38, each character for the note will be printed. 

Line 610 erases the last row of the note. 

Line 620 turns off the sound. 

Line 630 sends the program back to 410 to open the keyboard and wait for another key to be 
pressed. 

Line 800 is the timing routine. The program uses it everytime a note is printed on the screen. 
Without it, the characters would be printed too fast on the screen. 

In the next two programs, the character set for an airplane is redesigned. The plane will 
travel from right to left across the screen. Listing 4-2 uses graphics mode 2 without the text 
window. Listing 4-3 uses the text mode. In both programs, the plane shows some hesitation. The 
movement is not as smooth as in the previous program. This is because more than one character is 
moving on the screen at the same time. In the previous program, only one character was moving at 
any particular time. BASIC was fast enough to erase one character and replace it with a new one. 
In these programs, the five characters that create the plane are moving at the same time. There 
are three characters that must be erased while the plane is being drawn in the new position. 
BASIC is too slow to erase and draw this many characters at one time. 
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Listing 4-2. Simple Animation—Second Method 


:LO REM LISTING 4.2 
20 REM SIMPLE ANIMATION 
30 REM BY L.M. SCOREIBEE FOR TAB BOOKS 
40 nIM PLN«(4) t PN1$(3)yPN2$< 3) yP1$(20) 
5 0 A=P E E K ( 10 6 ) - 8 i C B= A Xc2 5 6 i R E M P L A C E C H 
ARACTER SET 2K BEFORE END OF MEMORY 
60 POKE 204 y A l POKE 206 y 224 X REM STORE T 
HE NEW CHARACTER SET ADDRESS AND THE R 
OM ADDRESS 

70 FOR X = 1 TO 20JREAD BJPi$<X»X)=CHR*( 
B ) t N E X T X J R E M M A C HIN E L A N G !J A G E S U B R 0 U T 
INE TO MODE CHARACTER SET 

7 5 D A T A 10 4 y 16 2 y 4 y 16 0 r 0 r 3. 7 7 y 2 0 5 r 3. 4 5 1 2 0 
3 y 2 0 0 r 2 0 B y 2 4 9 y 2 30 y 2 0 6 y 230 y 2 0 4 t 2 0 2 t 2 0 8 t 
242y96 

8 0 Q=U S R ( A D R < P .1. $) ) J R E M U S E M A C HIN E I... A N 
GOAGE PROGRAM WITH THE USE FUNCTION 

90 FOR X8 TO 63 X READ CJPOKE CB+XyCiNE 
XT X 


10 0 D A T A 0 y 8 y 8 y 1 j 


1 1 0 D A T A 0 y 0 y 8 y 3. J. y 7 y 13. y 8 y 0 

3.2 0 D A T A 0 y 0 y 0 y 3.3. y 7 y 3.3. y 0 y 0 

L 30 DATA 0 y 0 y 0 y 0 y 3.2 y 30 r 30 y 30 

. 4 0 D A T A 3 0 * 3 0 1 30 y 2 5 5 * 2 5 5 y 2 5 5 t 3 0 y 3 0 

L 5 0 D A T A 3 0 y 3 0 y 3 0 y 3 0 y 3.2 v 0 y 0 t 0 

!. 6 0 D A T A 0 y 6 y 7 y 2 5 4 y 25 5 y 2 5 4 y 7 y 6 

1.70 GRAPHICS 3.7 i REM LARGE COLOR TEX I 

.80 POKE 756yA 

1.9 0 P I... N $ a " " J P N 3. $ a " $ « i p N 2 * a " % 

200 FOR Xa3.5 TO 0 STEP -•3. SEEM FROM F 


I. y 7 y 3. 3. y 8 y 8 


II y II 
<X 


HT TO LEFT ACROSS THE SCREEN 


2 3. 0 IF X / 4 a IN T ( X / 4 ) T H E N P L N $ < 3. y 1) a ” ! " 
iGOTO 230 J REM USE LONGEST PROP ONCE OU 
T OF 4 

2 20 P I... N $ < 3. y 3 . ) = C H R $ ( 3 4 ) . IF X / 4 -1N T ( X / 4 ) 
a 0.5 T H E N P I... N $ ( 1 r 3. ) ^ " # " i R E M U S E S H 0 R T E 
ST PROP ONCE OUT OF 4 

230 P 0 SIT10 N X y 3.0 i ? # 6 y P N 3. $ t P 0 SIT10 N X 
y 3.3. : ? # 6 y P I... N $ i P 0 SIT10 N X y 3.2 J ? # 6 y P N 2 $ 
240 FOR T=1 TO 25 i NEXT T 
250 NEXT X i REM GO ALL THE WAY ACROSS 
260 GOTO 3.70 
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Fig. 4-2. Character set for airplane. 
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Line 40 dimensions 4 strings. Pl$ will be used for the machine language subroutine that 
moves the character set from ROM into RAM. The other three strings will store the characters 
for. the airplane. 

Line 50 subtracts 2K from the amount of RAM in the system. The variable CB will hold the 
decimal address of the first memory location of the new character set. 

Line 60 pokes the address of the new character set into location 204 and the address of the 
ROM character set into location 206. These two locations are used by the machine language 
subroutine. 

Line 70 places the machine language subroutine in Pl$. Be sure that the data line is entered 
correctly. 

Line 80 sends the program to the machine language subroutine. When the program returns to 
BASIC, the ROM character set will be in RAM. 

Line 90 reads the data in lines 100-160 to change seven characters in the RAM character set. 
See Fig. 4-2 for the characters that will be replaced. 

Line 170 changes the graphics mode to 17—large color letters with no text window. 

Line 180 tells the computer to use the new RAM character set. 

Line 190 sets each string so that it will form a particular part of the airplane. The plane uses 
three rows on the screen. The main body of the plane is stored in PLN$. This is the propeller, the 
body of the plane and the tail. PN1$ is the top wing; PN2$ the bottom. There is one space after the 
characters in each string. This space is needed to erase the character that was drawn in that 
position previously. 

Lines 200-250 move the airplane across the screen. The variable X is the column that the 
plane will be drawn in. By starting with 15 and counting backwards to 0 (step -1), we will be 
moving the plane from right to left. Lines 210-220 will determine which propeller to use. One out 
of every four positions will use the longest propeller. When the variable X divided by 4 is equal to 
the integer of X divided by 4, the computer will use the longest propeller, which is a redefined 
exclamation point. If this propeller is used, the program will be directed to line 230. In line 220, 
the middle size propeller is placed into the string. It is the redefined quotation mark. Since BASIC 
will not allow a quotation mark within quotation marks, the ATASCII value must be used for this 
character. This propeller size will be used twice in every spin. Now the variable X is checked to 
see the shortest propeller. The longest propeller is used when X can be evenly divided by 4. The 
shortest propeller is used when the remainder of X divided by 4 is .5, or half-way between 
numbers. When the remainder is .5, the propeller will be changed to the character that replaces 
the pound sign. Otherwise, the propeller is already set to the correct length. Line 230 prints the 
plane in the three rows on the screen. The column is set by the value of X. Line 240 is a short 
timing loop. Without it, the plane would move too fast across the screen. 

Line 260 sends the program back to line 170 to repeat it again and again. To stop this 
program, press the system reset key. 


Listing 4-3. Animation in the Text Mode 


10 REM 
20 REM 


40 DIM I 

'i 


.ISTING 4,3 

ANIMATION IN TEXT MODE 


30 REM BY L. ♦ M ♦ SCHREIBER FOR TAB BOOKS 


1 L N $ ( 2 0 ) y P N1 $ C 3 ) 9 P N 2 $ ( 3 ) y P 1 $ ( 2 0 


5 0 A=P E E K (10 6 ) - 8 i C B = A * 2 5 6 l R E M PI... A C E C H 


55 





Listing 4-3. Animation in the Text Mode (continued from page 55) 


ARACIER SET 2K BEFORE END OF MEMORY 
60 POKE 204 y A ? POKE 206 > 224 ? REM STORE T 
HE NEW CHARACTER SET ADDRESS AND THE R 
OM ADDRESS 

70 FOR X=1 TO 20JREAD B?PI$(X r X)=CHR*( 
B ) t N E X T X: R E M M A C HIN E L A N G U A G E S U B R 0 U T 
INE TO MOVE CHARACTER SET 
75 DATA :L 04 y 162 y 4y160 y 0 y 177 y 205 y J. 45 y 20 
3>200 t 208 y249 >230 y206 y230 y204 y 202y 208 y 
242y96 

8 0 G=U S R ( A D R ( P .1. *) ) ? R E M IJ S E MAC HIN E L A N 
GUAGE PROGRAM WITH THE USR FUNCTION 
90 FOR X~8 TO 63?READ CtPOKE CB+XyCJNE 
XT X 

.1.00 DATA 


1.10 
120 
130 DATA 


140 DATA 


0 y 8 y 8 y 1.1 >7 >11* 8 y 8 
DATA 0 * 0 y 8 y 11 >7* 11y8y0 
0 y 0 y 0 y 11 y 7 y 1 1 y 0 y 0 
0 y 0 y 0 y 0 y12 v 30 y 30 y 30 
30y 30 y 30 y 255y255y255 y30,30 


A 


150 

I 

lATA 

30 y 30 

9 

30 

>30*12 

*0 

y 0 y 0 


160 

l 

lATA 

0 y 6 y 7 

y 

25 

4 y 255 y 

25 

4 y 7 y 6 


170 


11 >" 

? POKE 


75 

2y1? RE 

M 

ERASE 

CURSOR 

180 

F 

'OKIE 

756 y A 







190 

F 

■L.N$= 

“ ! %$ 

& 

/ 

II 




200 

F 

OR X 

••V !••• "V* ,*•% 

•••• 1 u 

1 

STEP 

•••• 1 

? REM 

FROM RIG 

HT 

T( 

LIEF 

T ACR 

OSS 

THE S 

CR 

EEN 


210 

] 

F X/ 

4=1 NT 

< 

V / 
/\ / 

4) THE 

N 

PLN$ < 

1 y 1) = " ! " 


? GOTO 230?REM USE LONGEST PROP ONCE OU 
T OF 4 

22 0 P L N $C 1y1 )* C H R $(34)?IF X / 4 - 1 N T < X / 4) 
0 * 5 T H E N P I... N $ (1 y 1 ) ~ " * " ? R E M U S E S H 0 R T E 
ST PROP ONCE OUT'OF 4 

2 3 0 P 0 SIT10 N X y 10 ? ? P L N $ > ? R E M U SIN G A 
S E MIC 01... 0 N R E D U C E S F LIC K E RIN G 
240 FOR T=1 TO 20?NEXT T 
250 NEXT X ? REM GO ALL THE WAY 
260 ? 


ACROSS 


" > “ ? GOTO .200 


This program is essentially the same as the previous one. It is, however, done in the text 
mode. The two lines that are different are 40 and 190. 

Line 40 dimensions two strings. This time PLN$ is dimensioned to 20 to accommodate the 
entire plane. 

Line 190 stores the entire plane in PLN$. This string should read—exclamation point, 
percent sign, escape up-arrow, escape back-arrow, dollar sign, space, escape down-arrow, escape 
down-arrow, escape back-arrow, escape back-arrow, and sign, space, escape up-arrow, escape 


56 









i t 

i i 

i i 

i i 


l 

l 

! 1 





1 ! 1 ! 

J. 

I -1 

l .1. 



1 

1 

i : :i. i 

1. 

! :i. 

1 

1 

1 

i 

.». 

i: i: 


! :L 

1 

1 

:l. 

1 

1 1 1 ! 

1 

i -i 

i .i. 

.1. 

1 

■i 

4. 

1 

l; :i.: 

1, 

: :i. 

•1 

.1. 

1 ! 


1 

1 ! 1 ! 


i 

i 


I"' k:* 
. ..I ^.1 

*"i i"‘ ?::* 

%j -...i 

2 5 5 


•• I ! a A 

A.. \.* I 


-i !::• i::* 
. 1 . ! 


” i::* i:r 

. i . i 


••••« !::• »::• 
% ..i ....i 

••• I*** I*** 

> o ,v.» 

•••) i::* i::* 

A*.. •...* \J 

2 5 5 

2 !j 

2 0 4 


j B 

B 

B 

B 

B 

B 

B 

B 

! B 

B 

B 

B 

B 

B 

B 

B 

! B 

T.V 

A.' 

B 

B 

B 

B 

B 

B 

! B 

B 

B 

p 

A.' 

B 

B 

B 

B 

: B 

B 

B 

B 

B 

B 

B 

B 

I B 

B 

B 

B 

B 

B 

B 

B 

! B 

B 

B 

p 

A.' 

B 

B 

B 

B 

! B 

B 



B 

B 




i i 


i) 

:l. ? 2 


v 4 Ci 

A.. \..* •*••• 

••*;« i::; i::; 

I— I*** 

.j % j 

... .... 

2 !"i ,"i 


! ') 4 


1 

1 

! B 

B 


1 

» 

1 

i 

1 

l 

! 

1 


1 1 ( 

1 » t 

1 1 1 

1 1 1 

! B 

B 

B 

B 1 

1 

1 


1 ! t 

I 1 1 

■ p 

B 

B 

B 1 

B ! 

B 

1 1 1 

1 1 1 

1 Y/i 

1 A,* 

y:.« 

A.' 

p 

A. 1 

b : 

B 1 

B 

! B 1 B ! 

! B 

B 

P 

A.' 

*1*1 1 
.D I 

B ! 

B 

! BIB! 

! B 

B 

P 

A.' 

B ! 

B ! 

B 

i b : b i 

! B 

B 


1 

1 

B J 

p 

A. 1 

1 1 t 

1 1 1 


•••• 1 

{ I ! !. .! 


Fig. 4-3. Character set for carousel. 
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Fig. 4-3. continued from page 57. 
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back-arrow, apostrophe, space. 

The new spaces must follow the upper and lower wings and the tail to erase the characters 
that were previously drawn in those locations. 

Both programs display some animation. If the for .. . next loops are left in the program, but 
the position of the plane in line 230 is made constant, you can see the propeller spin on the plane. It 
is very difficult to see it spin when the plane is moving across the screen. 

SCENES AND MOVEMENT 

Up to now, the programs that we created made very limited use of the character sets. The 
characters were simply created and the animation or movement was there, but there was very 
little in the way of a scene. 
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Scenes need two parts, the background or picture, and the characters that will move. The 
ATARI uses the term background to indicate the color of the screen. This color will show through 
any character, letter, or number that has any bits that are not turned on. If you print the letter 0 on 
the screen in graphics 2, the 0 would appear orange. The center of the 0 would have the 
background color showing through. Try this in the direct mode: 

GR. 2:POSITION 2,2:? #6;“0” 


The background color in all modes except the text mode is stored in decimal location 712. 

Playfield characters are either the characters that can be printed on the screen in graphics 
modes 0-2, or the lines that are drawn on the screen with the plot and drawto commands in the 
other graphics modes. In the last three programs, the playfield characters were notes, pipes, and 
pieces of an airplane. 

The playfield characters can be numbers, letters or graphic characters. The next program 
will draw a carousel on the screen using redefined characters. ANTIC mode 5, which will produce 
large multicolored characters, will be used in this program. 

In ANTIC modes 4 and 5, characters are colored by setting one or two bits in every two bit 
set to indicate the desired color. Both pixels are turned on to that color. The characters appear to 
be 4x8. In contrast, in the text mode or in graphics modes 1 and 2, each bit that was set in the 
character turned on the corresponding pixel. An 8x8 grid contained one character. 

In Fig. 4-3, the characters that replace the ROM characters are drawn. Instead of an X in the 
location of a pixel that is turned on, a 1 or a 0 is in that bit position. Next to it is the decimal code 
that will be used in the program. Next to that is a drawing of how the character will look on the 
screen. The B pixels will appear blue on the screen, the R will be red and the Y yellow. 
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Listing 4-4. Carousel 


10 REM LISTING 4*4 
20 REM CAROUSEL 

30 REM BY L * M♦ SCHREIBER FOR TAB BOOKS 
40 DIM P1 $(20) 

5 0 A - P E E K (10 6 ) - 8 J C B=A * 2 5 6 l R E M PI.. A C E C H 
ARACTER SET 2K BEFORE END OF MEMORY 
60 POKE 204 y A:POKE 206» 224 J REM STORE T 
HE NEW CHARACTER SET ADDRESS AND THE R 
OM ADDRESS 

70 FOR X=1 TO 20: read b:pi*<x»X)=chr*< 
B ) i N E X T X : R E M M A C HIN E L A N G U A G E SIJ B R 0 U T 
INE TO MOVE CHARACTER SET 

7 5 D A T A 10 4 r 16 2 y 4 y16 0 y 0 t 17 7 y 2 05 y 14 5 y 2 0 
3y200 y208 y 249y230 y 206 y230 y204 y202 y208 y 
242y96 

8 0 Q=U S R < A D R ( P1 $ ) ) t R E M U S E M A C HIN E L A N 
GUAGE PROGRAM WITH THE USR FUNCTION 

90 FOR X2 4 TO 95 J READ C 5 POKE GB+XyGJN 
EXT X 

10 0 D A T A 0 y 3 y 15 y 6 3 y 2 5 5 y 255 y 25 5 y 2 0 4 

110 D A T A 2 5 5 y 2 5 5 y 2 5 5 y 2 5 5 y 2 5 5 y 2 55 y 2 5 5 y 2 

04 

120 DATA 0 y .1.92 y 240 y 252 y 255 y 255 y 255 y 204 
130 DATA 9 y 6 y 5i y 5 y 9 y 6 y 5 y 5 

14 0 D A IA 14 4 y 9 6 y 8 0 y BO y 14 4 y 9 6 y 8 0 y 8 0 

15 0 D A T A 14 4 y 9 6 y 8 0 y 8 0 y 14 4 y 9 6 y 2 5 5 y 2 5 5 
160 DATA 9 y 6 y 5 y 5 y 9 y 6 y 255y 255 

18 0 D A T A 2 y 2 y 2 y 2 y 15 y 6 3 y 25 5 y 2 5 5 

19 0 D A T A 21 y 8 4 y 21 y 0 y 19 2 y 2 4 0 y 25 2 y 2 5 2 
200 GRAPHICS 17 

210 DLIST » PEEK < 560 ) + PEEK ( 561) #256 J REM 
FIND THE BEGINNING OF THE DISPLAY LIST 
220 POKE DLIST+3 y 69 

230 FOR X~6 TO 28tPOKE DLIST+Xy 5 l NEXT 
X t REM CHANGE ENTIRE DISPLAY LIST TO AN 
TIC 5 

240 POKE 756yA 

250 POSI TION 17 y 2 ♦ ? #6> REM FLAG 0 

N TOP 

2 6 0 P 0 SIT10 N 7 y 4 t ? # 6 y " # $ $ $ $ $ $ $ $ $ $ $ $ <|i $ 
$ $ <|> $ $ $ % “ 

270 FOR X : “6 TO 18 STEP 2 1 POSITION 7 y X: 

? #6 y ” & & / ■' " * NEXT X t RE 

M PRINT THE POLES 
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280 POSITION 7vXr? 
N N N N > ( > N N N N N > C > N > " 
290 GOTO 290 


# 6 v " > N > ) > N N N N N > ) > N N 


Lines 40-190 are the same as in the last program. In this program only one string is 
dimensioned. Otherwise, the machine language subroutine to move the character set from ROM 
to RAM is the same. The data lines replace the characters from the pound sign to the plus sign. 
These characters will draw the carousel on the screen. 

Line 210 calculates the beginning of the display list. As mentioned before, this program will 
use ANTIC 5, which will produce multicolored characters. 

Line 220 changes the first row on the screen from graphics mode 0 to ANTIC 5. 

Line 230 changes the rest of the display list from graphics mode 0 to ANTIC 5. 

Line 240 tells the computer to use the RAM character set. 

Lines 250-280 print the new characters on the screen. The *+ is the flag on the top. The roof 
has 20 dollar signs ($) between the pound sign (#) and the percent sign (%). Line 270 draws the 
poles. There is one space, the and sign (&), five spaces, the and sign (&), six spaces, the 
apostrophe (’), five spaces, and another apostrophe (’). The last line prints the bottom. It uses the 
same spacing as the poles, CTRL N, close parentheses {)}, five CTRL Ns, close parenthesis {)}, 
six CTRL Ns, open parenthesis {(}, five more CTRL Ns, one last open parenthesis {(}, and a final 
CTRL N. 

Line 290 loops back to itself. 


To add animation to this scene, we will use the player/missile graphics. Players and missiles 
are terms used by ATARI for special characters that can be created and stored in memory. They 
are unlike the character sets because each player is only 8 bits or 1 byte wide. The player is, 
however, as tall as the display screen—using 255 bytes in the single line resolution or 128 bytes 
in double line resolution. Each player can be thought of as a band that extends from the top of the 
screen to the bottom. The character is drawn on this band. It can be moved from side to side, and 
up or down. 

Because the players are stored in an area of memory other than the memory used for the 
screen display, their image seems to be superimposed onto the background and playfield 
characters. 

In this program, we will create a horse for the carousel. To make it look realistic, we will use 
two players side-by-side. The horse can move up and down while it is going around on the 
carousel. Figure 4-4 shows how the horse is created. 

Figure 4-5 shows the amount of memory needed for player/missile graphics. There are two 
different modes for player/missile graphics: single resolution and double resolution. In the single 
resolution mode, each byte is one row or pixel high on the screen. Each player and missile has 256 
bytes of memory set aside for it. The area of memory set aside for the players and missiles must 
begin on an even 2K boundary. This means that the first byte of the memory must be evenly 
divisible by 2048. An easy way to find the boundary is to subtract 4 from the end of memory for 
every IK. Memory location 106 contains the amount of memory available in the computer. In a 
40K system, the amount stored in this memory location is 160. Multiply 160 by 256 and you get 
40960—the amount of actual RAM available. Each time you subtract 1 from the number, you are 
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actually subtracting 256 bytes. By subtracting 4, you will subtract IK from the amount of available 
RAM. Since the operating system uses IK of RAM for the screen display and display list in mode 
0, you cannot use the last IK of RAM for the player/missile graphics. If you subtracted 8 from the 
amount in memory location 106, you would have an even 2K boundary, but you would be using the 
same memory that the screen and display list were using. When you are using single line 
resolution for our player/missile graphics, we subtract 16 from the amount of RAM available. 
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This leaves 2K for the screen and display list and gives us an even 2K boundary to begin our 
graphics. 

The second mode for player/missile graphics is the double resolution mode. This mode 
draws each byte on the screen twice as high, or uses two rows for each byte. Since it draws each 
byte twice, it uses only 128 bytes for each player or missile. The entire mode uses IK of memory. 
To set aside memory for player/missile graphics that are double resolution, we need to start on an 
even IK boundary. We can subtract 8 from the amount of RAM available. This will give us IK for 
the player/missile graphics and IK for the screen and display list in the text mode. 

In addition to the two modes, the players and missiles can be in any of three sizes. When we 
set the mode to single or double resolution, we do it for all the players and missiles. Each player 
and/or missile can be in one of three sizes independent of each other. If the size is not set, the 
players and missiles will default to normal size. Each bit in the byte will be one pixel wide. Double 
size makes each bit two pixels wide and quadruple size makes the figure four times as wide as a 
normal one. Note: These figures refer to the width of the player. The resolution determines the 
height of the character. 

By adding a few lines to the previous program, we can add a horse to the carousel. The 
following program uses double width and double line resolution. 

Listing 4-5. Carousel—Animated 


10 REM LISTING 4*5 
20 REM CAROUSEL 

30 REM BY L.M. SCHREIBER FOR TAB BOOKS 

4 0 n IM P1 H> ( 2 0 ) 1 - LI P $ ( 2 0 ) y B 0 W N $ ( 2 0 ) 

5 0 A=P E E K < 10 6 > - 8 J C B=A * 2 5 6 t R E M PI... A C E C H 
ARACTER SET 2K BEFORE END OF MEMORY 

60 POKE 204 y A t POKE 206y224 t REM STORE T 
HE NEW CHARACTER SET ADDRESS AND THE R 
OM ADDRESS 

70 FOR X-1 TO 20 i READ BJP1*(X»X)=CHR*< 

B ) t N E X T X t R E M M A C HIN E I... A N G U A G E S S U B R 0 U 7 
INE TO MOVE CHARACTER SET 
7 5 D A T A 10 4 y .1.6 2 » 4 y 16 0 y 0 y 17 7,2 0 5 v 14 5 y 2 0 
3y 200 y 208 y249 y230y206 y 230,204 y 202 y 208 y 
242 y 96 

80 Q ;::; USR ( ADR ( P1 $ ) ) i REM USE MACHINE LAN 
GUAGE PROGRAM WITH THE USE FUNCTION 
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1 6 0 D A T A 9 >■ 6 r 5 y 5 » 9 y 6 y 2 5 5 y 2 5 5 
180 DATA 2*2*2 y2y15y 6 3 y255y255 
19 0 D A T A 21 y 8 4 y 21.0 r 19 2 r 2 4 0 y 2 5 2 y 2 5 2 
200 REM DRAW CAROUSEL 

2.1.0 ? " > C I... E A R > " J D LIS T « P E E K ( 560 ) + P E E K < 5 
61)*256iREM FIND THE BEGINNING OF THE 
DISPLAY LIST 
220 POKE DLIST+3y 69 

2 3 0 F 0 R X ••••• ■• 6 T 0 2 8 J P 0 K E D LIS T+X y 5 J N E X T 


XJREM CHANGE ENT 
TIC 
240 


IRE DISPLAY LIST TO AN 


5 


.... .... / /. 
/ 'j & 9 A 


i:: 

A* m 


50 


POKE 
POSITION 


.1 •••■ 
.1. / 


<• •:> 

♦ ! 


*#+":rem flag on t 


op 

2 6 0 P 0 SIT10 N 7 y 2 : ? " # $ $ $ $ $ $ $ $ $ $ $ $ $ $ $ $ $ 
$$$%' 

270 FOR X3 TO 9 J POSIT I ON 7 y X J ? 


II < 




"JNEXT XJREM PRINT THE 


X 

POLES 

2 8 0 P 0 SIT10 N 7 , X J ? ■ > N > ) > N N N N N > ) > N N N N N 


N>(>NNNNN><>N>” 

290 REM DRAW THE HORSE USING PLAYER/MI 
SSII..E GRAPHICS 

3 0 0 A1 = A - 4 J R E M P L A Y E R / MIS SIL E G R A P HIC S 
ARE IK ABOVE THE CHARACTER SET 
310 P1=A1 * 2 56 + 512 t P 2 ~ P1 + . 1 . 2 8 l P 3 ^ P 2 f 12 8 1 
P 4=P 3+12 8 i R E M FIR S T M E M 0 R Y I... 0 C A T10 N 0 F 
PLAYERS 

320 FOR X=P1 TO A*256-1JP0KE XyOJNEXT 
XJREM CLEAR OUT THE MEMORY 
330 FOR X-Pl+70 TO PIT79 J READ CJPOKE X 
y C J NEXT XJREM GET DATA FOR THE HORSE 
340 FOR X-P2+39 TO P2+65J POKE Xy128JNE 
XT X J FOR X=P2+66 TO P2+78J READ CJPOKE 
X y C J NEXT XJREM OTHER HALF OF HORSE 
3 50 F 0 R X - p 2 + 7 9 T 0 P 2 •}• 10 2 J P 0 K E X y 12 8 J N 

EXT XJREM REST OF THE POLE 

360 FOR X---P3+58 TO P3T70 J READ CJPOKE X 

y CJ NEXT X 

3 7 0 F 0 R X=P 4 + 31 T 0 P 4+61 J P 0 K E X y 12 8 J N E 
XT X J FOE X--P4+62 TO P4+71 J READ CJPOKE 
X y C J NEXT X 

3 8 0 F 0 R X =•• P 4 f 71 T 0 P 4 T 9 4 J P 0 K E X y 12 8 J N E 
XT XJREM REST OF THE POLE 
3 9 0 P 0 K E 5 5 9 y 4 6 J R E M D 0 LJ B L E I... IN E R E S 01... U 
TION FOR P/M GRAPHICS 










Listing 4-5. Carousel—Animated (continued from page 65) 


•400 POKE 53277 v 3$ POKE 54279 v A :U REM ENA 
BLE P/M GRAPHICS 

410 P 0 K E 6 2 3 y 4 X R E M S E T P L A Y FIE I... D C H A R A 
CTER3 PRIORITY OVER P/M GRAPHICS •••• EN 
ABLE FIFTH PLAYER 

4 2 0 P 0 K E 7 0 4 v 118 X P 0 K E 7 0 5 y118 I P 0 K E 7 0 6 
y116:POKE 707y116 t REM HORSE OF A DIFFE 
RENT COLOR 

4 3 0 P OK E 5 32 5 6 t 1 $ P 0 K E 5 3 2 5 7 y 1 l P 0 K E 5 3 2 

5 8 v 1 t P 0 K E 5 3 2 5 9 y 1 X R E M M A K E H 0 R S E L A R G E 
R 

4 4 0 H1 = 10 5 5 H 2 = 121 5 P 0 K E 53 2 4 8 y H1: P 0 K E 5 
3249 y IT2 » REM PUT HORSE ON THE SCREEN 
4 50 BA TA 15y31y 63 y 47 y 42 y4 2 v10 y18 y3 6y8 
4 6 0 D A T A 13 2 y 14 2 y 15 9 y 19.1. y 2 5.1. y 2 4 0 y 2 2 4 y 2 
4 0 y 16 8 y 16 8 y 2 0 0 y 14 4 y 16 0 

4 70 D A T A 3 2 y 112 .» 2 4 8 y 2 5 2 y 22 3 y 15 y 7 y 31 y 2 0 
y 20y18 y 9 y 4 

4 8 0 D A T A 2 5 2 y 2 5 4 y 2 5 5 .» 2 53» 14 9 y 14 9 y 14 8 y 1 
4 6 y 13 7 y 4 

500 FOR X”1 TO 13JREAD B t UP*(XyX)~CHR$ 
( B) : N E X T X : R E M M A 0 HIN E I... A N G U A G E S U B R 0 U 
TINE FOR UP 

510 D A T A 10 4 y 16 0 y 0 ? 2 0 0 y 17 7 y 2 0 5 y 13 6 y 14 5 
y 205 y 200 y 208 y 247 y 96 

520 FOR X=1 TO 13JREAD BJDOWN$<XyX)=CH 
R $ (B ) : N E X T X : R E M M A C HIN E L A N G U A 0 E S U B R 
OUTINE FOR DOWN 


5 3 0 D A T A .1.0 4 y 16 0 y 2 5 5 y 13 6 y 17 7 y 2 0 5 y 2 

4 5 y 2 0 5 y 13 6 y 2 0 8 y 2 4 7 y 9 6 

5 4 0 P 0 1 ~ IN T ( P 1 / 2 5 6 > J P 0 2 = ( P 1 - 1N T ( P 1 
) * 2 5 6 ) : P 0 3=IN T ( P3 / 2 5 6 > X P 0 4 * (P 3 -1N T 
256)*256)JREM HI/L0 A DDRESS 0 F H0 R 
5 5 0 T R A P 6 6 0 t R E 8 T 0 R E 6 4 0 : DIR=2 : H P1 

4 8 J H P 2 ~ 53 2 49 5 P 0KE 2 €* 6 ? P 01 t P 0 K E 2 0 5 
:REM MOVE TO THE RIGHT - PLAYERS U 

5 6 0 F 0 R X = 1 T 0 9 : MU S R ( A D R < U P $ ) ) : G 
670 : N E X T X: G 0 S U B 6 0 0 

5 7 0 P 0 K E 2 0 6 y P 0.1. : P 0 K E 20 5 y P 0 2 1 1F D 
2 T H E N P 0 K E 2 0 6 y P 0 3 : P 0 K E 2 0 5 y P 0 4 
5 8 0 F 0 R X - 1 T 0 9 : M == U S R ( A D R < D 0 W N $ ) ) 
IJB 670 J NEXT X l GOSUB 600 J GOTO 560 
590 REM HORSE MOVING ROUTINE - DIR 

POSITIVE •••• HORSE MOVES TO RIGHT ~ 
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Line 300 subtracts IK from the beginning of the character set. The character set begins on an 
even boundary, so subtracting 4 (or IK) from its beginning yields an even boundary for our 
players. 

Line 310 calculates the beginning address for each player. The first player (PI) begins 512 
bytes after the beginning address for the player/missile graphics. The next player and each 
subsequent player begin 128 bytes after the previous player. We have already decided that these 
players will use double line resolution, so we know how much memory should be set aside for 
each player. 

Line 320 clears the memory that will be used for the players. When the computer is turned 
on, or after a program has been run, there can be garbage in the memory area that we will be using. 
This line removes any data that may have been left there. 

Lines 330-380 draw the horse in the player/missile area of memory. Player PI is the back 
portion of the horse going to the right. Player P2 is the front of the horse and the pole. Player P3 is 
the front portion of the horse going to the left and player P4 is the back and the pole. The data to 
draw the horse is read from lines 450-480. 

Line 390 pokes memory location 559 with 46. This sets the player/missile graphics to double 
line resolution. 

Line 400 enables the player/missiles by poking 53277 with a 3 and tells the computer where 
the player/missiles begin by poking 54279 with the value stored in Al. Now the computer knows 
where the graphics are stored, and what the resolution of the graphics should be. If location 53277 
is not poked with a 3, the player/missile graphics will not be enabled. Using player/missile 
graphics in a program requires both location 559 to be set and 53277 enabled. 

Line 410 sets the priority levels of the players and characters on the screen. In this program, 
the characters that are printed on the screen will have higher priority than the players. This will 
make the horse appear to go behind the poles of the carousel. 

Line 420 sets the colors used in the four players. The first two locations are for the first two 
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players. This is the horse as it is going from left to right. The next two locations are for the third 
and fourth players. This color is a little darker than the first color. The horse will be going from 
right to left. The darker color will give it the illusion of being further away. 

Line 430 sets the size of the horses. By poking each of these locations with a 1, we will make 
each of the four players double the normal size. 

Line 440 places the horse that is facing the right on the screen. Locations 53248 and 53249 
set the first two players on the screen. To remove them from the screen, poke these locations 
with a 0. 

Line 500 is the machine language subroutine that moves the horse up. Be sure that the data in 
line 510 is entered correctly. If it isn’t, the horse will not move up correctly. 

Line 520 is the machine language subroutine that moves the horse down. The instructions for 
this machine language subroutine are in line 530. 

Line 540 calculates the beginning address of the first and third player. The machine language 
subroutines move 256 bytes up or down. The first horse uses the first two players, which add up to 
256 bytes. The second horse uses the third and fourth players or the next 256 bytes. This line 
stores the high and low order address of the players in the variables P01, P02, P03, and P04. 

Line 550 uses the trap command to test for the end of data. 

Lines 640-650 contain the melody that the computer will be playing while the horse is going 
around. This melody will be played over and over. When the computer runs out of data it will come 
up with an error. The trap will direct the computer to Line 660. This line will reset the trap and 
restore the data. The DIR variable is the amount that will be added or subtracted from the position 
of the horse on the screen. When DIR is positive, the horse will move from left to right. When DIR 
is negative, the horse will move from right to left. HP1 and HP2 are the registers that are poked 
with the position of the horse on the screen. Memory locations 205 and 206 are poked with the 
memory location of the first player. Two bytes are needed for this location because the memory 
address is greater than 255. 

Line 560 moves the horse up nine rows. The music subroutine is accessed every time the 
horse moves up one row. After the horse is moved up, the subroutine that moves it to the right or 
left is accessed. 

Line 570 reinitializes the memory locations that are used in the machine language sub¬ 
routines to the player that is being moved. If DIR is positive, the location of the first player will be 
stored in locations 205 and 206. If DIR is negative, the positions of the third player will be stored 
in these locations. 

Line 580 uses the machine language subroutines to move the horse down. Again, the music 
subroutine will be accessed each time the horse is moved down one row. The subroutine to move 
the horse to the right or left will be used after the horse is moved down nine rows. These three 
lines will be repeated over and over again until the system reset key is pressed. 

Line 600-620 contain the subroutine that moves the horse to the left or right. The value of 
DIR is added to the position stored in Hi and H2. If DIR is positive, two will be added to this value. 
If DIR is negative, two will be subtracted from this value. (Adding a negative number is the same 
as subtracting a positive number.) This line also checks the position of the horse on the screen. If 
the horse is at the end of the carousel, the value of DIR is reversed, the horse that is on the screen 
is removed, and the registers that control the position of the other horse are placed in variable 
HP1 and HP2. The other horse is then placed on the screen and the program returns. 

Line 660 reinitializes the music routine. The program goes to this line when it runs out of 
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data. The trap is reset, the pointer for the data is restored to line 640. The program continues with 
the next line. 

Line 670 reads a note every third time that this routine is accessed. We can calculate every 
third time beginning with the first time by adding 2 to the value of X and dividing it by 3. If it is a 
whole number (a number without a remainder) a new note will be read and played. 

Line 680 turns the note off every third time that this routine is accessed. This time we simply 
divide X by 3. If it is a whole number, then the note will be turned off. The program will return to 
the main program. 

SETTING THE PRIORITIES 

In the last program, the horse seems to move behind the poles. The pole that the horse is on 
moves up behind the roof of the carousel and appears above it. 

When the player/missile graphics are initialized, we can set priorities for the players, 
missiles, and the characters. The players can appear to move in front of the characters, behind the 
characters, or in front of some and behind others. Figure 4-6 illustrates the order of priority and 
the value that must be poked into decimal location 623. The playfield refers to the playfield 
characters, the characters that are printed on the screen or drawn on the screen with the plot and 
drawto commands. Th eplayers are the characters formed by the player/missile graphics. Player 5 
is the fifth player or the missiles as a group. Note: The missiles can be used as four characters, 
each two bits wide, or as a fifth character eight bits wide. To enable the fifth player, poke 623 with 
16 4- the priority code. 

As shown in Fig. 4-6, the top player or playfield has the highest priority. This character will 
appear on the screen in front of any other. Player 0 always has the highest priority followed by 
players 1, 2, and 3. 

In the next program, which is a simple bird and fish game, we will set the priority code to 8. 
The players will move behind the playfield characters 0 and 1, but in front of playfield characters 2 
and 3. 

Some of the clouds are drawn using the color in playfield character 0, others use the color in 
playfield character 2. The water is made up of three different waves. Depending on the playfield 
color used, the fish will or will not be seen. 

Listing 4-6. The Birds 


10 REM LISTING 4*6 
20 REM THE BIRD 

30 REM BY I... * M ♦ SC HREI BEE FDR TAB BOOKS 

4 0 n IM P1 $ ( 2 0 ) 9 LJ P $ ( 2 0 ) 9 D 0 W N $ ( 2 0 > 

5 0 A « P E E K < .1.0 6 > - 8 t C B~A * 2 5 6 l R E M P L. A C E C H 
ARACTER SET 2K BEFORE END OF MEMORY 

60 POKE 204 yA t POKE 206y224 i REM STORE T 
HE NEW CHARACTER SET ADDRESS AND THE R 
OM ADDRESS 

70 FOR X :::: 1 TO 20 {READ B ♦ P1 $ ( X y X ) ~CHR$ ( 
B > J N E X T X J R E M M A C HIN E I... A N G U A 0 E S U B R 0IJ T 
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Listing 4-6. The Birds (continued from page 71) 
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Lines 40-190 are the same as the past few programs. In this program they will dimension the 
strings used for the three machine language subroutines. The machine language subroutine to 
move the character set from ROM to RAM is the same. The data lines replace the characters from 
the pound sign to the plus sign. These characters will draw the clouds and the water on the screen. 
See Fig. 4-7 for these characters. 

Line 200 sets the mode that will be used: large color characters with no text window. Poking 
756 with the value of A changes the character set. 

Line 210 changes the colors of the characters. There will be two colors used for all the 
characters: white and green. The background will be changed to light blue. 

Lines 220-240 place the clouds on the screen. The position for the clouds is chosen 
randomly. No two screens will look the same. If the first or fifth cloud is chosen, the program will 
add the second half of the cloud. Half of the clouds on the screen will be drawn with the characters 
in the normal character set. The other half of the characters will be drawn as if they were printed 
in inverse video. The color will be the same, white, but the priority will be different. 

Lines 250-260 print the top of the water on the screen. This time every third will be printed 
as a inverse video character. 
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Line 270 colors the bottom of the screen with water. 

Line 280 calculates the beginning of the player/missile graphics area. In this program we are 
using the single resolution character set so the player/missile graphics must begin on an even 2K 
boundary. By subtracting 8 (2K) from the beginning of the character set, we know where to begin 
the player/missile graphics. The first player begins 1024 bytes from the beginning of the memory 
set aside. The second and third players are 256 bytes apart. 

Line 290 clears the area of memory that will be used for player/missile graphics. This 
memory could contain data from a previous program or garbage. This would show up on the 
screen in the player/missile area. 

Line 310 pokes 559 with 62. This tells the computer that we are using single resolution for 
these players. 

Line 320 enables the player/missile graphics. If a 3 were not poked into 53277, the 
player/missile graphics would not be enabled. Poking 54279 with the value of A1 tells the 
computer where the player/missiles begin. 

Line 330 sets the priorities of the players and characters. The characters that would be 
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printed as normal characters have a higher priority than the player/missile graphics. The 
player/missiles have a higher priority than the characters that are printed in inverse video. 

Line 340 sets the color for the players. The bird will be black and the fish are green. 
Remember, there are two fish images as players, one that is swimming and one that is caught. 

Lines 360-390 first restore the pointer to line 380. This is the first line of data for the fish. 
The first time that the program is run, there is no problem having the computer read the correct 
data for the fish. If the program is played again, without rerunning it, the pointer will be pointing to 
one of the lines of bird data. After the pointer is set to line 380, the program reads the data into the 
player/missile graphics area that is set aside for the second and third players. 

Line 400 chooses a number from 0 to 2. There are three different ways that the bird can be 
drawn on the screen. The program chooses one, restores the pointer to that line, then reads the 
data into the area set aside for the first player. 

Line 460 places the machine language subroutine that will move the player up into UP$. Be 
sure that the data is entered correctly. 

Line 480 places the machine language subroutine that moves the players down into DOWN$. 

Line 500 finds the first memory location of the first player. This location is greater than 255, 
so it occupies two bytes. The high order address, that is, the whole number of the address, is 
stored in the variable P01. The low order address, the remainder, is stored in P02. This address is 
used by the machine language subroutine. 

Line 510 chooses a random number for the vertical position of the bird. The bird will always 
be the same distance from the top of the screen, but it can appear in any column on the screen. 
This number is stored in V. VI is the vertical position of the fish on the screen. The beginning 
address of the first player is placed in memory locations 205 and 206. The program is then 
directed to the subroutine in lines 720-730. This places the words BIRD and FISH on the screen 
along with a score (0) for each. 

Line 520 clears the hit register. In the ATARI computer, there is one memory location that 
registers when a player hits a missile, characters, or another player. This register must be 
cleared before it can be read. By poking location 53249 with the value stored in VI, we place the 
fish on the screen. One is subtracted from VI. The next time the program executes this line, it will 
move the fish over one to the left. If the value in VI becomes equal to 20, the fish is nearly off the 
screen. The value of VI is reset to 200. 

9 

Line 530 sends the computer to line 630. The computer will check the joystick to see if it has 
been moved. When the computer returns to this part of the program, the bird may have moved up 
or down, or the value in variable V may have changed indicating that the bird has moved either to 
the right or the left. 

Line 540 moves the bird to the right or left by poking the value of V into register 53248. The 
computer then chooses a random number to change the wings on the bird. The number is added to 
400 and the pointer for the data is restored to this line. The computer reads the new data for the 
bird and pokes it into the area of memory in the player/missile graphics area that the bird 
occupies. The variable PI is the beginning of the first player’s area of memory. The variable U is 
the offset for the first byte of the bird. It increases and decreases as we move the bird up and down 
on the screen. 

Line 560 checks the register that will record whether or not the bird (player 1) has hit the fish 
(player 2). If the bird has not hit the fish (PEEK(53260)< >2) and the fish has been placed back on 
the right side of the screen, (VI =200) or if the bird is resting on the water (U=149) and the fish 
has moved four places, the fish will be given a point. This keeps the player from landing the bird on 
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the water and waiting for the fish to come by. The subroutine in line 720 updates the score and the 
computer continues the program with line 520. 

Line 570 sends the computer back to line 520 if the bird has not hit the fish. 

Line 580 removes the swimming fish from the screen. The computer will execute this line if 
the value in register 53260 is 2. The swimming fish is replaced by the hanging fish. The score for 
the bird is increased by one. 

Line 600 pokes the beginning address for the third player, the hanging fish, into memory 
locations 206 and 205. The machine language subroutines to move the fish up and down are 
executed ten times. The fish never really moves up and down. This gives the effect of the fish 
wiggling while the bird tries to eat it. 


Table 4-1. Machine Language Listing to Move Players Up/Down. 
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Line 610 erases the bird. The bird will be redrawn in the player area of memory. If we don’t 
erase the bird, we will have two birds in that area when we only want one. 

Line 620 updates the score and sends the computer to line 500 where the bird is repositioned 
on the screen and you are given another chance to try to catch a fish. 

Lines 630-670 check the joystick to see if it has moved. If it has been moved up or down, the 
computer will use the correct machine language subroutine to move the bird. The variable U1 will 
be changed to reflect the new position of the bird on the screen. If the joystick has been moved to 
the left or right, the variable V will change. 

Line 720 updates the score on the bottom of the screen. 

Line 730 checks the score to see if either the bird or the fish has over 100 points. If neither 
does, the computer will return to the same. 

Line 740-760 ends the game when either the fish or the bird passes 100. The computer 
checks location 53279 to see if the start key has been pressed. When the value of this location is 6, 
the start key has been pressed, and the program can continue. The scores are cleared, the players 
are removed from the stage and the program goes to line 200 to begin the game again. Since this 
was entered as a subroutine, the return address is popped off the stack. If the return address for a 
subroutine is not popped off the stack, it will stay there. If more and more addresses are placed on 
the stack and never removed, the stack could run out of space, causing the program to crash. 

Table 4-1 contains explanations of the machine language subroutines that are used to move 
the players up and down. Each machine language subroutine that is to return to BASIC must pull 
the last byte off the stack. If it doesn’t, the subroutine will not return. 
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Chapter 5 

Looking 
at BASIC 


By now, writing programs in BASIC is almost as natural as writing letters in English. But, did you 
ever wonder how the computer interprets the commands that you type in? Or how it knows that 
the line that was just entered contains an error? Just what does the computer do with a program? 

THE TOKEN COMMANDS 

Each time that you see a variable in a line or command, BASIC looks it up in its Variable 
Name Table. Each variable is assigned a number in the order that it was entered. This number is a 
token that represents the variable name in the line or command. If the variable appears in the 
table, BASIC assigns its token for the variable. If it doesn’t appear in this table, it is added to the 
table. Up to 128 variables can be used in one BASIC program. 

The BASIC commands are converted into token commands. A number or token represents 
every command that BASIC knows. A one number token uses less memory than a four or five 
character word. As you enter a program line, BASIC converts the line into a string of numbers or 
tokens. This makes it easy for BASIC to execute the program. 

The line numbers that you enter are converted into two byte numbers and stored in the area 
that BASIC sets aside for the program. Why two bytes? BASIC will accept line numbers up to 
32767. When this number is converted to hex, it becomes 7FFF, the largest positive sign number 
possible. Any number in hex 8000 or larger is considered a negative number, BASIC does not 
allow negative line numbers. 

By changing the line number that we entered into a two byte number, every line in BASIC 
will have two bytes set aside for line numbers. This makes it easy for BASIC to manipulate the 
lines. 

Once the line number has been converted into a two byte number, a dummy number will be 
placed into the line. This number will contain the offset, or the number of bytes in this line. Right 
now, BASIC does not know how many bytes are needed for this line. The next number is how 
many bytes are in this statement. Since there can be more than one statement on each line, BASIC 
must keep track of both the line length and the statement length. This number will also be a 
dummy number until the entire line is checked. 

Now that BASIC knows that this is a program line, it looks for a command. The entire list of 
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Table 5-1. BASIC’s for Tokens Commands. 


TOKEN 

COMMAND 

0 

EEM 

1 

.U A i i r) 

n 

INPUT 

•*y 

•w.J 

COLOR 

4 

L 1ST 

5 

ENTER 

6 

•••i 

LET 
t i:r 

/ 

8 

.1. 1 

FOR 

o 

NEXT 

10 

GOTO 

1 :l. 

GO TO 

12 

GO SUB 

13 

TRAP 

14 

BYE 

f 15 

CO N T 

16 

COM 

17 

CLOSE 

' 18 

C L R 

19 

DEG 

/•% /> 

0 

DIM 

p i 

Am .1. 

END 

'*) o 

NEW 

/'•, "V 

A 

OPEN 

•”> 

r 

LOAD 

•***i r,!' 

A.. V.. 1 

b R v 1::. 

/ 

/ A. 

C: *Y* A *Y* | 1 <:;* 

A*.. \.f 

%..• 1 ri i U \.t 


possible commands is in ROM. If the first command following the line number is not in this list, an 
error message will appear on the screen. 

If the command is found in the table, it will be converted into a code or token value. 
Depending on the command, BASIC will check the next part of the statement to make sure that it 
is accurate. For example, the print command must be followed by double quotes, a variable, or a 
string variable, FOR must be followed by a variable that is equal to a number, the next part of the 
command, TO, and another number, TRAP must be followed by a line number or a variable, etc. If 
any element of the statement is missing or otherwise incorrect, BASIC will stop checking the 
line, reprint it on the screen, with the word ERROR, and highlight the possible problem area. 
Once BASIC has determined that the statement is correct, it will replace the dummy numbers 
with the correct figures and wait for the next statement or line to be entered. 

A complete list of commands and their BASIC tokens are listed in Table 5-1. Each command 
has its own numerical token. When you enter a BASIC statement into the computer and you do not 
type the entire word out; for example, GR. 1 instead of GRAPHICS 1 , and you list the program, 
BASIC will expand the command and print it correctly. When entering a BASIC program, you only 
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save keystrokes, not bytes, when you use the abbreviated forms of the commands. The command 
will use the same amount of memory no matter which way it was entered. The same is true about 
spaces. On certain other computers, you can save memory by eliminating the spaces in the 
statements. ATARI BASIC will automatically place spaces between the commands when it lists 
the program on the screen. 

FILE STRUCTURES 

When we store a value in a variable, string, or array, BASIC must be able to reference the 
variable and to store or retrieve the information. First, it must be able to identify the type of 
variable. Then, it must have memory set aside for it. 

Each time we use a new variable in our program, we use eight bytes of memory. A string and 
an array uses the eight bytes plus the size of the string or the array. The names of the variables are 
stored in a table. A second table stores the value of the variable or the location in memory that 
stores the string or array information. Because of the amount of memory that is used by variables, 
strings, and arrays, we try to reuse variable names whenever possible. 
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However, it is better to use variables than numbers in a program if you will be using the 
number often. For example, if you will be going to a line fora timing routine from different parts of 
the program, it saves memory to make the line number for timing routine equal to a variable, and 
then GOSUB the variable. 

BASIC TABLES 

The first table that BASIC uses is called the Variable Name Table. Every variable used in a 
program is assigned a number from 0 to 127. If you try to use more than 128 variables in a program 
you will set an error message. 


Listing 5-1. BASIC Tables—Variable Name Table 


10 REM LISTING 5-1 
20 REM BASIC TABLES 

30 REM BY L.M. SCHREIBER FOR TAB BOOKS 


4 0 DIM A < .1.0 t 2 ) v S T HIN G * (10 ) 

5 0 T A B I... E ~ P E E K (13 0 > 1 P E E K < 131) >K 2 36 6 

6 0 F 0 R X=T A B I... E T 0 T A B L E+2 0 l ? C H R $ ( P E E K 
(X) >fi NEXT 


\ .* 
V 


If you enter the program without any errors, your screen should display - 

A(STRIN G$TABLEX 

and some other characters. The underlined characters appear in inverse video on the screen. 

Look at the listing. Each variable appears in the order that it was entered into the program. If 
an error was made, for example, PRRK was typed in line 50 instead of PEEK, BASIC would have 
treated PRRK as a variable and placed it in the table even if you corrected it before the program 
was run! 

Each type of variable is stored differently in the table so that BASIC can tell which are 
variables, arrays, and strings. If it is a variable, its last character is stored with the most 
significant bit set. This makes the character appear in inverse on the screen. The E in the variable 
table is in inverse. The X is only one character long, so it is in inverse video. 

If the variable is an array, the character after the variable is an open parenthesis with the 
most significant bit set. The first variable in our table is an array. 

If the variable is a string variable, the first character after the variable will be the $ with the 
most significant bit set. STRINGS has the most significant bit of the $ set. 

As new lines are typed in for a program, BASIC checks this table to see if each variable has 
been used before. If it has, BASIC assigns its token for the variable. If it doesn’t appear in this 
table, it is added to the table and its token is used in that line. 

Because each variable is stored in this table, shorter variable names will, of course, use less 
memory. But, because each variable has its own token in a BASIC line, you only save memory in 
the variable table. The program will use the same number of bytes whether the variable is one 
character long or 10 characters long. 

Once the variables have been stored in the Variable Name Table, BASIC has the token 
number for that variable. The first variable is 0, the second 1, etc. Information for each variable is 
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stored in the Variable Value Table. Each variable is listed in this table in the order that it is listed 
in the Variable Name Table. Let’s add these lines to our program. 


Listing 5-1A. BASIC Tables—Variable Value Table 


10 REM LISTING 5-1A 
20 REM BASIC TABLES 

30 REM BY I.... M ♦ SCHREIBER FOR TAB BOOKS 

4 0 DIM A(10 t 2) f ST RIN G*(10) 

5 0 T A B L E - P E E K ( 13 0 ) + P E E K (131 ) * 2 5 6 

60 FOR X®TABLE TO TABLET20 t ? CHET(PEEK 
(X)) $t NEXT X J? tREM SH0W THE VARIABLES 
IN THE TABLE 

7 0 0 L. U E = P E E K ( 13 4 ) + P E E K ( 135)*25 6 l R E M A D 
DRESS OF THE VARIABLE VALUE TABLE 

so p--o:foe x=vlue to vlue+3i:rem show 

IN F 0 R M A T10 N F 0 R FIR S T 4 V A RIA B L E S 
9 0 P RIN T P E E K ( X ) v : p=p +1 * 11- P ••= 4 0 R P=8 
THEN PRINT l IF P~8 THEN PRINT :P=0 
100 NEXT X 


The numbers that appear on your screen tell the computer what kind of variable each one is 
and supplies information on its contents. Your screen should look like this: 


65 

0 

0 

0 

11 

0 

3 

0 

129 

1 

198 

0 

0 

0 

10 

0 

0 

2 

65 

118 

118 

0 

0 

0 

0 

3 

65 

119 

37 

0 

0 

0 


The first eight bytes (numbers) contain information for the first variable A. The 65 indicates 
that it is a dimensioned array. The 0 is the variable number. A is the first variable entered in this 
program. The next two bytes are added to the beginning of the string/array area to find the 
beginning of the data for the array. In this case, A is the first variable dimensioned, so its data will 
not be offset from the beginning of the string/array area. It will be contained in the first 198 bytes. 
The next two numbers, the 11 and the 0 are a two byte value for the first dimension of the array. 
Our array is dimensioned to 10,2; the first dimension is 10. The first dimension of the array is 
always one greater than the value in the dimension statement. The last two numbers, the 3 and 0 
is the second value of the array. Again, this value is one greater than the value in the DIM 
statement. 

& 
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Table 5-2. Variable Value Table. 



The second group of numbers is the information for our string, STRING$. The first byte is 
129. This means that this variable is a dimensioned string. The next byte is the variable number. 
STRINGS is the second variable in the table. The next two bytes contain the offset that is added to 
the beginning of the string/afray area to find out where the data for the string is stored. The 
contents of the first byte is added to the contents of the second byte after it is multiplied by 256. In 
this case, the second byte is zero. So we know that the information stored in STRINGS begins 198 
bytes after the beginning of the string/array area. The next two bytes contain the length of 
STRINGS. We have not stored anything in this string, so its length at this time is zero. The last 
two bytes in this group tell the computer how many bytes to set aside for this string. We 
dimensioned STRINGS to 10, so the first of the two bytes is 10, the other is zero. 

The next group of bytes contain the information for the variable TABLE. This variable was 
not dimensioned. It was the next variable that was entered into the computer. The first byte for 
this variable is a zero. This means that it is a numeric variable. Only one number can be stored in 
this variable. The next byte is the variable number. This is the third variable in this program, so 
its number is 2. The next six bytes contain the value of TABLE. Since only one number can be 
stored in a numeric variable at a time, the computer stores this information right in this table. It 
uses six bytes because it stores the number as a Binary Coded Decimal. This format differs from 
the format used when the computer stores a number using two bytes. At this point it is not 
necessary to understand how or why the computer uses this format, just that it does. 

The last group of bytes contain the information for the variable X. Again, this is a numeric 
variable as indicated by the zero. It is the fourth variable used in this program so its number is 4. 
The value stored in X is represented in the next 6 bytes. Table 5-2 is a chart showing the different 
ways the variables can be represented in the Variable Value Table. 

The area set aside for the strings and arrays is called the String/Array area. The address for 
the beginning of this area is stored in memory locations 140 and 141. Let’s add the following lines 
to our program. 

Listing 5-1B. BASIC Tables—String-Array Area 


10 REM LISTING 5*IB 
20 REM BASIC TABLES 

30 REM BY I... ♦ M * SCHREIBER FOR TAB BOOKS 

40 DIM A < 10 12 ) f STR ING$(10) 

5 0 T A B1... E ™ P E E K (13 0 > + P E E K < 131 > * 2 5 6 
60 FOR TABLE TO TABLET.20 ♦ ? CHR$ ( PEEK 
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( X) ) y t N E X T X : ? { ? : E E M S H 0 U T H E V A RIA B 
LES IN THE TABLE 

70 VI...UE=PEEK ( 134 ) + PEEK ( .1.35) *256 } REM AD 
DRESS OF THE VARIABLE VALUE TABLE 

8 0 P = 0 J I- O R X = V L U E T 0 VI... U E+3.1. t R E M S H 0 W 
IN F 0 R M A T10 N F 0 R FIR S T 4 V A RIA B L E S 

9 0 P RIN T P E E K < X > » : P=P i 1 i IF P=4 0 R P =•• 8 
E N ? " " 5 IF P=8 T H E N P RIN T J P=0 i R E M 


PRINT ESC-CTRL-UPARROW IF 4 OR 8 
100 NEXT X 

110 STRINGS-"HI THERE" 

120 F0R X=VLUE+8 T0 VLUE +15 * ? PEEK < X ) y 
i NEXT XJ? I REM SHOW THE CHANGE IN THE 
VARIABLE VALUE TABLE 

13 0 S "f A R E A=P E E K (.1.4 0 ) + P E E K < .1.41 ) * 2 5 6 J R E M 
FIND THE BEGINNING OF THE STRING/ARRA 
Y AREA 

:l. 4 0 M E S S A G E :::: S T A R E A +19 8 * R E M FIN D T H E S T 
RING 

15 0 F 0 R X - H E S S A G E T 0 H E S S A G E •}• L. E N ( S T RIN 
G*)-IS REM START TO END OF STRING* 

1 6 0 ? C H R $ ( P E E K ( X > ) i * R E M P RIN T T H E C H A 
RACTER OF THE VALUE IN THIS AREA 
170 NEXT X 

I 8 0 ? t ? " S T RIN G ~" y S T RIN G $ 


The fifth group of bytes is nearly identical to the second group. This is the information for 
STRING$. The only byte that is different is the fifth byte. It contains an eight because the 
message in STRING$ is eight characters long. The next line prints the contents of STRING$ by 
peeking at the area in memory where STRINGS is stored. Finally, STRINGS is printed to show 
that the message is the same. 

By knowing this information, it is possible to trick the computer into looking at memory that 
was not originally set aside as a string by the computer. In the nexLchapter you will learn how to 
manipulate this information. 

Another area of memory that BASIC uses is the Output Buffer. When a BASIC line is entered 
into the computer, the entry must be stored somewhere while it is being tokenized and checked 
for the proper structure. The area set aside for this is stored in memory locations 128 and 129. 
This area or buffer is 256 bytes long. 


Listing 5-1C. BASIC Tables—Buffer 


10 REM LISTING 5.1C 


S 


20 REM BASIC TAB! 

30 REM BY I.... M. SC HR FIBER FOR TAB BOOKS 

4 0 DIM A ( 10 y 2 ) y S T RIN G $ (10 ) 

5 0 T A B L. E - P E E K C13 0 ) + P E E K ( 131)* 2 5 6 

60 FOR X— TABLE TO TABLET 20 i ? CHR$( PEEK 
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Listing 5-1C. BASIC Tables—Buffer (continued from page 85) 


:? 


JREM SHOW THE VARTAB 


( X ) ) y J NEXT XJ? 

LES IN THE TABLE 

70 VLLJE-PEEK (134 ) + PEEK (135 ) *256 J REM AD 
DRESS OF THE VARIABLE VALUE TABLE 
80 P=OJFOR X-VLUE TO VLUE+31JREM SHOW 
INFORMATION FOR FIRST 4 VARIABLES 
9 0 P RIN T P E E K ( X ) y 1P=P+1 J IF P * 4 0 R P ~ 8 
THEN ? “"UP P“8 THEN PRINT JP-0JREM 
PRINT ESC-CTRL-UPARROW IF 4 OR 8 
100 NEXT X 

110 STRINGS-"HI THERE" 

12 0 F 0 R X - V L U E+8 T 0 V L U E +15J ? P E E K ( X ) y 
J NEXT XJ? JREM SHOW THE CHANGE IN THE 
VARIABLE VALUE TABLE 

130 STA R EA -PEEK(14 0)+PEEK < 141 ) * 2 56JREM 
FIND THE BEGINNING OF THE STRING/AREA 
Y AREA 

1 4 0 M E S S A G E=S T A R E A f 19 8 J R E M FIN D T H E S T 
RING 

15 0 F 0 R X-M E S S A G E T 0 M E S S A G E+L E N (S T RIN 
G*>~1JREM START TO END OF STRING* 

160 ? CHR*(PEEK(X ) ) y J REM PRINT THE CHA 
RASTER OF THE VALUE IN THIS AREA 
170 NEXT X 

18 0 ? J ? " S T RIN G = 11 y S T RIN G $ 

190 BUFFER-PEEK (128 ) + PEEK ( 129 ) *256 J REM 
BEGINNING OF THE BUFFER 


200 FOR X=BUFFER TO 
PEEK(X)>y JREM PRINT 
E BUFFER 
210 NEXT X 


BUFFER!150J? CHR*< 
THE CONTENTS OF TH 


'I'he contents of this buffer will vary from program to program depending on what has been 
entered into the computer. 

Once the lines of the program have been tokenized and placed in the program, BASIC has to 
know where in memory the program begins. The address of the beginning of the BASIC program 
is stored in the Statement Table in memory locations 136 and 137. By adding a few more lines to 
the program you can see the tokenized BASIC program. 


Listing 5-ID. BASIC Tables—Statement Table 


10 REM LISTING 5* 

20 REM BASIC TABLES 

30 REM BY L*M» SCHRElBEE 


FOR TAB BOOKS 
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4 0 

DI 

n r ^ J. u y 

2) »STRING!; 

< 10) 




5 0 

•V* A 

1 R 

BLE~PEE 

K(130)+PEE 

K ( 13 .1. 

J a’.. V.! 

6 


60 

F 0 

R X T A B 

I...E TO TABI... 

E+20 J 

? CHR$ 

(PEEK 

< X > 

) 5 

i NEXT X 

:? ;? t REM 

SHOW 

THE 

VARIAB 

I...ES 

IN THE T 

A h 1... I::. 





70 

U L 

U E-PEEK 

(134)+PEEK 

( 135) 

* 2 5 6 

<• 1"* 
* K 

EM AD 

DRE 

ss 

OF THE 

VARIABLE 

VALUE 

TABLE 


8 0 

j .’.' 1 ;;;; 

0 t F 0 R X 

VI...UE ro V 

LUE+3 

1 1 RE 

H 

SHOW 

INF 

GRMATION 

FOR FIRST 

4 VARIABI... 

E S 


90 

PR 

INT PEE 

k< x >x: p=p+ 

1 1 IF 

P~4 

OR 

P=8 

THE 

N 

? " " 11F 

P=8 THEN 

PRINT 

•> c . 

* 1 "** 

o: 

REM 

PRINT 

ESC---CTRL-UP ARROW 

IF 4 

OR 

8 


100 

N 

EXT X 






110 

8 

TRING$= 

"HI THERE " 





120 

F 

OR X“VL 

UE+8 TO VI... 

UE+15 

i ? P 

•••• «••• 
1::. r. 

K (X) v 

! NE 

A 1 

X $ ? i R 

EM SHOW TI I 

E CHANGE 

IN 

THE 

V A RIA 

BLE VA 1... 

UE TABLE 





130 

b 

T A R E A = P 

E E K(140)TP 

EEK (1 

41 ) * 

A*.. 

6 t REM 


FIN D T H E B E GIN NIN G 0 F IH E SI R IN G / A R R A 
Y AREA 

.1.4 0 M E S S A G E=S T A R E A +19 8 i R E M FIN D T H E S T 
RING 

15 0 F 0 R X=M E S S A G E T 0 i v i E S S A G E+L E N ( S T RIN 
G %) “ 1 i R E M S T A R T T 0 E N D 0 F SIRIN G $ 

:l. 6 0 ? C H R $ ( P E E K ( X ) ) i l R E H P RIN T "(' H E C H A 
RACIER OF THE VALUE IN THIS AREA 
170 NEXT X 

18 0 ? t ? 11 S T RIN G = " > S T RIN G % 

1 9 0 B U F F E R=P E E K ( .1.2 8 ) + P E E K < 12 9 ) * 2 5 6 5 R E M 
BEGINNING OF THE BUFFER 

200 FOR X^BUFFER TO BUFFER!-150 'i ? CHR$< 
P E E K ( X ) ) i i R E M P RIN T T H E C 0 N T E N T S 0 F T H 
E BUFFER 
210 NEXT X 

2 2 0 P R 0 G R A M=P E E K < 13 6 ) + P E E K < 13 7 ) * 2 5 6 t R E 
i'i THE PROGRAM 

2 3 0 F 0 R X - P R 0 G R A M T 0 P R 0 G R A M +110 0 t ? C H 
R $ ( P E E K ( X ) ) ? i N E X T X * R E M P RIN T T H E T 0 K E 
NIZED PROGRAM 


The remarks are perfectly readable. The rest of the listing should look like code. It is. Every 
command is converted to one of the token values (Table 5-1). The variables have their own 
tokens. It would be very hard for you to try to read this listing. 

In order for BASIC to keep track of where it is when executing the program, it sets aside two 
bytes of memory to use as a pointer. Memory locations 138 and 139 contain the address of the 
current statement. When BASIC is not executing a program, this buffer points to the beginning of 
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the immediate line mode, which is the area that the next command will be placed if it is not a 
BASIC line, but an immediate command. 

When BASIC is executing a program, it also needs an area set aside for return statements 
and for . . . next loops. This is called the Run Time Stack. When BASIC executes a GOSUB, it 
must know where to return to. Four bytes are used for every GOSUB. One byte indicates that the 
next address is a return address for a GOSUB. The next two bytes contain the line number to 
return to. The fourth byte is the offset in the line, so that BASIC will continue with the next 
statement on that line. 

A for... next loop uses 16 bytes of memory in the stack: the last number that the variable can 
count to (6 bytes), the step of the for... next loop (6 bytes), the variable name of the variable that 
is counting, the line number (2 bytes), and the offset of the for statement. The first two numbers 
use the Binary Coded Decimal format. 

Incorrect use of the for ... next loop or GOSUBs without RETURNS and/or POPs can cause 
a program to crash. Table 5-3 is a chart that shows the addresses that BASIC uses to store this 
information. 

SPEEDING UP A PROGRAM 

Now that we have an understanding of how BASIC stores a program and the pointers that it 
uses to keep track of the program as it runs it, we can use different techniques to speed up a 
program and to use memory effectively. A well written program should run smoothly and use only 
as much memory as necessary. Having a computer with 48K in it does not mean that you should 
not try to conserve memory. If your short programs are written loosely, and you do not get into 
the habit of trying to write the program as tightly as possible, you will run out of memory very 
quickly when you try to write a large program. 

Sometimes the only way to shorten a program is to recode it. If the program was not flow 
charted or modifications were added to the program after it was written, you may find that the 


Table 5-3. Table of Addresses for BASIC Tables. 
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program has several routines that are the same. These routines can be made into subroutines, and 
several lines of code can be removed from the program. You may also find a subroutine that is only 
called once. Move that routine to the main program. GOSUBs and RETURNS waste bytes if the 
routine is only used once. 

Use a variable instead of a number if the number is used more than once. Each time a number 
is placed in a BASIC line, it uses 7 bytes. If the same number is used twice, that’s 14 bytes. 
Assigning a number to a variable uses 10 bytes. Each time the variable is used in a line, the 
variable’s token is placed in the line. This is one byte. Assigning a number to a variable, then using 
that variable twice uses only 12 bytes. Obviously, the more frequently the number will be used in 
the program, the more bytes will be saved. 

Place the most frequently called subroutines at the beginning of the program. BASIC begins 
at the beginning of the program and works its way down looking for lines. If the line is at the 
beginning, BASIC doesn’t have to look very far. 

If one subroutine calls another subroutine and then returns to the main program, have the 
first subroutine GOTO the second subroutine so that it will return to the main program from the 
second subroutine. 


Example 1 

100 GOSUB 500 
110 ... 

120 ... 

490 ... 

500 TL=10:PRINT“Let’s try that again”:GOSUB 600 
510 RETURN:REM this return is unnecessary - 

Example 2 

100 GOSUB 500:REM the correct way 
110 ... 

120 ... 

490 ... 

500 TL=10:PRINT“Let’s try it again.”:GOTO 600 

In the first example, line 500 contains a GOSUB. BASIC will go to that subroutine, then 
return to line 510. Line 510 contains a return. So, in effect, the computer is returning to a return. 
In the second example, the GOSUB is replaced with a GOTO. Line 600 is still a subroutine, it still 
has a RETURN at the end of it, but because the program went to the subroutine as a GOTO, when 
it comes to the RETURN, the address on the stack will be the next line in the main program. This 
method saves both time and memory. 

Use POKEs instead of SETCOLOR. This will save about 8 bytes. POKEs can also be used 
for the sound command. 

Use logic instead of comparison if possible. One way is to set a variable to 0 if the condition is 
false and to 1 if it is true. Then instead of an IF X= statement, you can use an IF X THEN. For 
example, you may have a program that has a printer option. The prompt DO YOU WANT A 
HARD COPY? appears. If the user answers yes, a variable is set to 1 (PRTR=1). If the user 
answers no, the variable is set to 0 (PRTR=0). Now, when you get to the part of the program that 
will print either to the screen or the printer, instead of a line that reads: 
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1200 IF PRTR$=“YES” THEN LPRINT “REPORTS” 

your line will read: 

1200 IF PRTR THEN LPRINT “REPORTS” 

If PRTR is one, the statement is true and the word REPORTS will be printed on the printer. 
If the variable PRTR is 0, the statement is false and the computer will go on to the next line. 

Use assembly language subroutines when possible. The assembly language subroutine to 
move the character set from ROM to RAM is shorter and faster than the BASIC routine. 

Place short lines together on one line. Each new BASIC line uses three more bytes than the 
same statement placed in an existing line. Be careful here with GOSUBs, and if . . . next 
statements. 

Many of the programming techniques used in commercial programs are not programming 
tricks, but good programming practices. 
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Chapter 6 

Tricks 
with Strings 


In the past few chapters, we have created animated scenes with various graphics modes and the 
player/missile graphics. In most of the programs, we printed the characters on the screen. With 
the player/missile graphics, we were able to move the character to the left or right by poking a 
register; we used a machine language subroutine to move the character up or down. Sometimes 
the movement was smooth, at other times it wasn’t. 

By placing the characters that form the graphics into strings, the animation that we are trying 
to create on the screen can often be simplified. The following program uses strings to move the 
graphics on the screen. It is an animated version of the classic puzzle of the farmer with a fox, a bag 
of wheat, and a duck. He must take all three across the river, but his boat can only carry one item in 
addition to himself at a time. If he leaves the duck with the fox, the fox will eat the duck. If the duck 
is left with the wheat, the duck will eat the wheat. To place the fox in the boat, press the f; press 
the w for the wheat, and the d for the duck. If you want the farmer to row alone, just press the space 
bar. 


Listing 6-1. The Farmer and the Duck, Fox, and Grain Puzzle 


10 REM LISTING 6,1 

20 REM FARMER AND THE DUCK? F 

AIN PUZZLE 

30 REM BY I... * M , SCHREIBER FOR T 

4 0 DIM W * ( 2 8 ) y W1* ( 2 8 ) y C $ < 2 0 ) y 

5 0 A=P E E K ( . 1 . 0 6 ) 8 i P 0 K E 2 0 4 y A 5 P 
24 l REM STORE THE BEGINNING OF 

6 OLD CHARACTER SETS 

60 FOR X'-1 TO 201 READ BJC*<X» 
) i N E XT X JR EM M A CHIN E LA N G UA GE 
NE TO MOVE THE CHARACTER SET 
70 D ATA 104 r162t 4 v1 60 y0 y177y 2 
3 v 2 0 0 y 2 0 8 f 2 4 9 y 2 30 y 2 0 6 y 2 3 0 y 2 0 4 
242y96 


OXy AND GR 


AD BOOKS 
TEMP*(28 
OKE 206y 
THE NEW 


2 


X)«CHR*<B 


SUB ROUT 
TO RAM 
05 


j y 


14 5 y 2 


y 202y208 


I 

0 

V 
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Listing 6-1. The Farmer and the Duck, Fox, and Grain Puzzle (continued from page 91) 


9 0 G=U S R (A D R (C $ ) ) 1 R E M M 0 V E T H E C H A R A CI 
ER SET 

100 CB~A*256iF0R G24 TO 1751 READ GIRO 
KE Q+GBrCJNEXT Q J REM MOVE THE NEW CHAR¬ 
ACTERS INTO RAM 

1 J.0 DATA 255 y 255 y 255 v 255,255 y 255 y 255 y 2 

in* c:* 

\J v/ 

111 

112 

113 

114 

115 

116 
117 


DATA 

DATA 

DATA 


A 


DATA 

DATA 


119 

120 
1 21 

I oo 

123 

124 

125 
70 


n /. 

A.. K.y 


127 

128 
130 
140 
150 


TA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 

DATA 


A 


0 y 0 y 19 2 y 2 4 0 y 2 5 2 1 25 5 r 2 55 r 2 5 5 
0 y 0 y 0 y 0 y 0 y 1 9 2 y 2 4 0 y 17 0 

0 y 0 y 0 y 0 y 0 y 8 y 13 0 y 17 0 

0 y 0 y 0 v 0 y 2 5 5 y 6 3 y .15 y 1 7 0 
0 y 0 y 0 y 0 y 2 5 5 y 2 5 5 y 2 4 5 y 215 
2 0 y 2 0 .« 16 y 2 0 y 2 2 3 y 12 7.» 2 5 5 y 17 0 
0 y 0 y 0 y 0 y 2 5 5 y 2 5 5 y 2 5 5 y 17 0 
0 y 0 y 0 y 0 y 2 5 5 1 2 5 2 y 2 4 0 y 17 0 
0 y 0 y 0 y 0 y 0 y 3 » 15 y 2 5 5 
0y 0y63y63y255 y255 y 
4 y 8 4 y 5 .» 5 r 2 5 5 y 25 5 y 2 5 5 y 17 0 
0 y 2 0 y 2 0 y 2 0 y 2 5 5 y 2 5 5 y 2 5 5 y 
0 y 1 y 5 y 1 y 255 y 255 y 255 .»170 


25 

.... 

/j 

II 

n 

Am 

.... 

•f 

••• 

5 

■ ••• 
5 

.... 

%„i 

It 

1 

7 

0 


i y 

•“> 

Am 

5 

5 

y 

1 

•••• •••• 
/0 

5 

y 

i 

7 

/ 

0 



"X 

\.} 

y 

2 

4 

5 

y 

165 

0 

V 

1 

7 

'j 

V 

170 


D A T A 
DLI ST 
POKE 
FOR Q 
Q1 POKE DL 
Y LIST TO 
160 POKE 
y 20 X POKE 
170 POKE 
####$%888 


0 y 0 y 0 y 0 y 2 0 y 2 0 y 2 0 y 2 0 
0 y 0 y 0 y 0 y 0 y 1 y 5 1 1 
0 y 0 y 0 y 0 y 4 y !:i 4 y 5 .» 5 
= P E E K ( 5 6 0 ) + P E E K ( 5 61 > * 2 5 6 
D LIS T+3 y 6 9 J R E M A N TIC M 0 D E 5 
- 7 T 0 28 X P 0 K E D LIS T + Q y 5 X N E X T 
IS T •}• 6 y 6 X R E M C H A N G E T H E DIS P L A 
ANTIC MODE 5 

7 0 9 y 15 2 X P 0 K E 710 y J. 9 8 X P 0 K E 711 

82 y 0 

7 5 6 y A X ? “ > 11 X P 0 SIT10 N 2 0 y 8 X ? " 

8 X X X 8 8 8 8 8 8 8 8 8 8 8 8 8 88 8 8 8 8 8 8 y # # 


# #" 

180 FOR G=9 TO 121 POSITION 20 y Q X ? "222 

o •••> n •••) ■'•) •••> '•) '•) •••) n •-) o •••) '"i •••> ***) '•) '*) •”) •“) •") •••) '■) •“> '•) •") / ‘) ii 

JU. *•.. A*.‘. Am .C. yd A- Am A - .. A"m Am Am Am Am Am A’m Am Am Am Am Am Am Am A"m A*m Am Am Am A'm Am A*m Am Am Am Am A‘m 

{NEXT G 

190 W$~" 8888888888888888888888 / <>*+&"J 
REM FARMER UPRIGHT 

20 0 W1$~" 888888888 88 8888 88888 8'#1* + 88" 
J R E M L E A NIN 0 F 0 R W A R D 

2 J. 0 P 0 SIT10 N 0 y 1 X ? " T A K E d U C K f 0 X w H E A 
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T'JREM SHOW OPTIONS 

2 2 0 C iH ~ " 5 3 4 11 J F=1. X F1 = 0 X W ~ 1. X W1-0 X D - 1 X 
Dl=OJPOSITION 26 y 3 X? w$jrem PRINT FARM 
ER-SET VARIABLES 

2 30 P 0 SIT10 N 2 .1.y 7 J ? C * <1» 3 > J P 0 SIT10 N 1 
6 * 8:? C*(4 *6)1 0PEN #1 t 4 r 0 * "K X “ X REM PRI 
NT POSITIONS OF DUCK-WHEAT-FOX 
2 4 0 0 E T # 1 v B X IF B > 12 ? T H E N B=B -12 8 X P 0 K 
E 6 9 4 y 0 5 R E M R E S T 0 R E F R 0 M IN V E R S E 


n 

V.. 1 

0 


IF 

D AND 


(B 

• • •• 

68 


OR 


B 

.... 

• ••• 

.1.00 

) 

.... i « ini 

1 HE 

N 


c 

$ 


6 

V 

6 

\ 


ll 

": w $ 

( 2 

6 

y 2 

X. 

) :::: 

ii 

0 " 

V 

if 
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•P 

( 

\.) 
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•...* 

) :::: 11 /) 

ll 

A 

D1 

.... 
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♦ 

♦ 

D 

.... 

/% 

10 

OTO 

29 
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X R 
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DUG 
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IF 
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70 
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F 

• ••• 

0 

■> 

<• 

F 
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•7 
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IF 

W AND 
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:::: 
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.... 
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.f 
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II 
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II 

/ If 
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W1 

= 1 J C 
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:::: 
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II 

J G 

OTO 

i"\ 
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280 GOTO 240 

2 9 0 P 0 SIT10 N 1 6 * 8 X ? C $ ( 4 * 6 ) X C L 0 S E # 1J W 

1 $ (2 5 ? 2 5 ) :::: W $ ( 2 6 ? 2 6 ) X R E M PIJ T 1N 0 T H E R S 
TRING 

300 FOR 0-1 TO 11:POSITION 26»8J? W1*J 
REM MOVE THE BOAT 

310 T E M P $ - W $ ( J. y 2 ) X W $ - W $ ( 3 > 2 8 ) X W $ (27? 2 8 
>=TEMP$iREM MOVE THE BOAT TO THE LEFT 
320 POSITION 26*81? W* 

3 3 0 T E M P $=W1 $ ( J. v 2 ) X W1 H> - W1 $ ( 3 v 2 8 ) I W1 $ ( 2 
7 y 28)™TEMP$ 

340 NEXT Q X IF FI AND D1 AND U1 THEN PO 
S I T 10 N 0 y 1 X ? " Y 0 U G 0 T I T ! ! * X 0 0 

TO 540 

350 IF F AND D THEN POSITION 0y1 X ? " 

FOX EATS DUCK!! “X GOTO 540 

360 IF D AND W THEN POSITION 0 ?1 X ? ” 

DUCK EATS WHEAT ”X GOTO 540 

3 7 0 W $ < 4 y 4 > - " * " X W1 $ ( 3 ? 3 ) - 11 % " X P 0 SIT10 N 

2 6 y 8 i ? w $ : P 0 SIT10 N 21 * 7 X ? C $ (1 * 3 > X 0 P E N 
1): 1 y 4 y 0 y " K X " 

380 GET #1y B♦IF B>127 THEN B=B-128JP0K 

E 694 y 0 * REM RESTORE FROM INVERSE 

390 IF D1 AND (B-68 OR B-100) THEN C$( 

3 y 3 ) - " " X W $ ( 4 y 4 ) := " 0 " X C $ ( 6 y 6 ) == “ 4 " X D1 - 0 X 
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Listing 6-1. The Farmer and the Duck, Fox, and Grain Puzzle (continued from page 93) 


n = 1 J G O T 0 4 3 0 J R E H D U C K 

400 IF F:L AND <B=70 OR B«102) THEN C$( 

1 y 1) =-■ “ ” J C $ ( 4 v 4 ) " 5 “ J W $ ( 4 y 4 ) •- " . " JF 1 0 J 

F~1 5 GOTO 430JREN IT'S THE FOX 

410 IF W1 AND (B=87 OR B~.1.19) THEN C*< 

2 y 2) - " " i C $ < 5 y 5 ) * ■ 3 * l U « ( 4 y 4 ) = " / 11 t W1 * 01 
W-l J GOTO 430 

415 IF B--32 THEN 430 
420 GOTO 380 
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OS 

IT 
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i y 8 t ? 

W $ 

JR 

BOAT 









2) ;::: W 

l $ 

( 
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A.. / 

r-i \ <■ *¥• r-; 

v a., o * I 1::. 1 

v i P $ < 3 y 

2 8 

) :::: 

$=TE 

M P 

$ 

JR 

EH 

HOME 

BOAT 

T 0 

R 


IGHT 

460 POSITION 26 9 St? Wl* 

4 7 0 T E M P $ (1 y 2 )= W $ ( 2 7 y 2 8 ) l T E M P $ < 3 y 2 8 ) * W 
$<1y 26):w*=TEMP$ 

480 NEXT Q 

490 IF FI AND D1 THEN POSI TION 0y1J ? " 


FOX EATS DUCK!! 
500 IF D1 AND WI ' 
DUCK EATS WHEAT 


“I GOTO 540 
IN POSITION 0 yI I? " 
"5 GOTO 540 


510 POSITION 1 6 » 8 J? C$(4*6) i W$< 2 6 y 26 >~ 
" * " i w 1 $ < 2 5 y 2 5 ) -• “ * " i P 0 SIT10 N 2 6 y 8 ? ? W $ 
530 GOTO 230 

540 FOR 0- 1 TO 1000? NEXT' 01 GOTO 170 


Line 40 dimensions four strings. The W$s will be the boat in the water. C$ is the machine 
language subroutine to move the character set from ROM to RAM. TEMP$ contains temporary 
information for the strings. 

Line 50 finds the top of memory available on your system and subtracts 2K from it. This is 
where the RAM character set will begin. This location is poked into memory location 204. The 
beginning of the ROM character set is poked into location 206. These two memory locations will 
be in the machine language subroutine. 

Line 60 is the machine language subroutine that moves the character set from ROM to RAM. 
Be sure that the data in line 70 is entered correctly. It must be typed in exactly or it won’t work. 

Line 90 uses the machine language subroutine to move the character set from ROM to RAM. 

Line 100 reads new characters into the character set. We will be replacing the characters 
from the pound sign (#) to number 5. See Fig. 6-1 for the new characters. To get the decimal 
location of the first byte in the RAM character set, we multiply the value of A by 256. Since we 
want to begin the new characters with the fourth character, we multiply 8 (bytes per character) by 
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3 (characters to skip). We will begin replacing the characters with byte 24. 

Lines 110-128 contain the data used to change the characters. Each line is a different 
character. 

Line 130 finds the beginning of the display list. We will be changing the display list to work in 
ANTIC 5. 

Line 140 changes the fourth byte of the display list to 69. This is the instruction that tells the 
computer that the next two bytes indicate where the screen memory begins, and the mode of the 
first line on the screen. 

Line 150 changes the rest of the lines in the display list to ANTIC mode 5. The seventh line of 
the display list is changed to ANTIC 6 (graphics mode 1). This line will contain text. 

Line 160 changes the colors that will be used in the program. Location 82 is poked with a zero 
to change the left margin on the screen. All the lines on the screen are 40 characters wide except 
the second line. This line is 20 characters wide. This places the margin in the center of the screen. 
If we don’t change the left margin to zero, the computer will skip the screen area that would 
normally be the left margin. Because it is now in the middle of the screen, there would be a 
strange empty line down the middle of the screen. 

Line 170 pokes location 756 with the new character set location. The screen is cleared and 
the shore lines and water are printed on the screen. Notice that the shore begins on the left side of 
the screen and extends to the right margin, but the program tells the computer to begin the print 
with position 20. All the lines after the second one are 20 characters off. 

Line 180 fills the bottom of the screen with blue. 

Lines 190-200 place the waves and the farmer in the boat into the two strings. In W$, the 
farmer will be upright; in Wl$, the farmer will appear to be leaning forward. 

Line 210 prints the options on the screen. The D in duck, the F in fox and the W in wheat are 
different colors; these are the keys that will be pressed to place that object into the boat and row it 
across. 

Line 220 places three spaces and the numbers 534 into C$. C$ will not be used any more in 
the program, so rather than use a different variable, we are reusing C$. The 5, 3, and 4 are the new 
characters for the fox, the wheat, and the duck. The next six variables will indicate where the fox, 
the duck, and the wheat are. F, W, and D will be set to 1 when the fox, the wheat, and the duck are 
on the right side of the screen. The Fl, Wl, and D1 will be set to one when the fox, the wheat, and 
the duck are on the left side of the screen. The farmer in the boat is printed on the screen. 

Line 230 prints the items on both sides of the screen. When the program begins, the first 
three elements of C$ will be empty. The fourth through sixth will contain the fox, the wheat, and 
the duck. The keyboard is opened for input. 

Line 240 gets a value from the keyboard. This value will be an ATASCII value for the key 
pressed. If the value of B is greater than 127, the inverse key has been accidentally pressed. By 
subtracting 128 from this value, it will be restored to the correct value. By poking location 694 
with a zero, the flag is reset for normal characters. 

Lines 250-270 check the key that has been entered for one of the three characters. If the 
variable for that character is a one, the first part of the if... then statement is true. We do not have 
to enter IF D = 1, IF D serves the same purpose. If the D is one, the computer will go on the second 
part of the statement and check to see if the D or d key has been pressed. If it has, the duck is 
placed into the boat. The redefined character for 0 is the duck. When the boat is on the right side of 
the screen, that part of the boat is the 26th position in the string. The third character in C$ will be 
the duck. This element is replaced with the 4, the duck on the ground. The variable for the left side 
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Fig. 6-1. Character set for farmer, duck, fox and grain. 
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of the screen is changed to a 1 and the variable for the right side of the screen is set to zero. The 
program goes on to line 290. The other two lines are the same. They use the redefined characters 
for the fox and wheat. 

Line 275 checks for the space bar. If the space bar is pressed, the program will go on to the 
next part of the routine and row the boat across the screen. Only press the space bar when you 
want the farmer to row the boat with nothing in it. 

Line 280 sends the computer back to line 240. The key that has been pressed is not one of the 
four correct keys, or the character that you are trying to take across the river is already on the 
other side. 

Line 290 reprints the fourth through sixth characters of C$ on the screen. The character that 
is in the boat will be removed from the shore. The keyboard is closed and the character that is in 
the boat in W$ is placed in Wl$. The boat is one character to the left in Wl$. 

Lines 300-340 form a for...next loop to move the boat from the right to the left. Wl$ is printed 
on the screen. This is the string with the farmer leaning forward in his boat. The oar is in a slightly 
different position also. The first two characters of W$ is stored in TEMP$. These two characters 
will end up at the end of W$. The rest of W$, from the third position to the end is placed in W$. 
This, in effect, moves the characters up two places. The characters stored in TEMP$ is placed in 
the last two places of W$. W$ is printed on the screen. The same procedure is repeated with Wl, 
except it is not printed on the screen. Wl$ is printed when the routine is repeated. When the loop 






























ends, W$ will be on the screen. The computer will check the values of FI, Dl, and Wl. If they are 
all 1, all three characters are on the left and the game is over. The winning message is printed on 
the screen. 

Line 350 checks the variables F and D. If both of these are a 1, then the fox and duck are 
together. Since they cannot be together, the message FOX EATS DUCK appears on the screen. 

Line 360 checks the values of D and W. If both of these are a 1, the duck and the wheat are 
together. The message DUCK EATS WHEAT appears on the screen. 

Line 370 restores the boat to normal in both strings, prints the empty boat on the screen, and 
prints the first three characters of C$ on the shore. The character that has been brought over on 
the boat will now appear on the land. 

Line 380 gets a new key from the keyboard. Again, the value is checked to see if the inverse 
key has been set. If it has, 128 will be subtracted and the flag reset. 

Lines 390-410 check the key that has been pressed against the values in the variables. If the 
correct key has been pressed, but the corresponding variable is a zero, then that character is on 
the other side of the river and the boat must be rowed back before the character can be placed in it. 

Line 415 checks for the space bar. If it has been pressed, the program will go on the routine 
that moves the boat back across the water. 

Line 420 sends the computer back to line 380 for a new input. The key pressed was not an F, 
D, or W or the space bar. 

Line 430 prints C$ on the shore. The character placed in the boat will be removed. The 
character is placed into Wl$. Again, because Wl$ is offset by one character, the character that 
was placed in the boat is placed one position to the left in Wl. 

Lines 440-480 move the boat back across the screen. The lines are similar to the ones that 
moved the boat across the screen the first time. This time the last two characters are placed in the 
first two positions of TEMP$. The first through 26th characters of Wl$ are placed in the 3rd 
through 28th elements of TEMP$. Then the contents of TEMP$ are placed in Wl$. The same 
procedure is used to move the boat in W$. 

Lines 490-500 check to see if the fox is left with the duck, or the duck is left with the wheat. 

Line 510 prints the fourth through sixth characters of C$ onto the shore. The new character 
will appear here now. The boat will be restored, and the empty boat will be printed on the screen. 
The program continues until the characters are all on the left side of the screen. 

Line 540 is a timing subroutine. It is used to give you a chance to read the message on the 
screen. 

To restore the screen, press the system reset key. 

MACHINE LANGUAGE SUBROUTINES 

Until now, you have placed machine language subroutines into a string by setting a position 
of the string equal to the character string of a number. Every program that moves the character 
set to RAM, or moves a player/missile up or down used the same machine language subroutine. 

The following two programs place a machine language subroutine in a string. The program 
then prints the string on the screen with a line number in front of it. By moving the cursor over the 
line and pressing return, we place the new line with the subroutine into the program. This line can 
then be stored on disk for future use. When you want this subroutine in a program, you do not have 
to use a for .. . next loop with the data lines. The line with the characters already in the string can 
be used. 
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Listing 6-2. Move Character Set 


10 REM LISTING 6*2 

20 REM MOVE CHARACTER SET 

30 REM BY I... * M * SCHEEIBER FOR TAB BOOK'S 

40 DIM C$(20 > 

50 FOR X=1 TO 20 ♦ READ B l C $ (X y X )~ C H R $ ( B 
) * N E X T X 

6 0 D A T A 10 4 y 1 6 2 y 4 y 1 6 0 r 0 r 17 7 y 20 5 y 14 5 y 2 0 
3 f 2 0 0 r 20 8 y 2 4 9 1 2 3 0 t 2 0 6 y 2 30 r 2 0 4 y 2 0 2 t 2 0 8 t 
242 t96 

» x " a /'i s " 


70 PRINT 
*<34>i? 6or? 


0 50 5 " c$- 11 .0 CHR* (34) 5C $ y CHR 


70 


Line 40 sets aside 20 bytes for the machine language subroutine. 

Line 50 reads the data into the string. When it finishes, each byte of the string will be an 
instruction of the subroutine. 

Line 70 clears the screen. The number 50 and the string will be printed on the screen. The 
numbers 60 and 70 will also be printed on the screen. 

Now move the cursor to the top of the screen and press the return key three times. Line 50 
will be replaced with the string that contains the subroutine. Lines 60 and 70 will be erased. To 
use this subroutine, subtract 2K from the amount of memory available in your system 
(A=PEEK(106)-8). Store the value of A in location 204 (POKE 204,A). Store the beginning 
address of the ROM character set in location 206 (POKE 206,224). To execute the subroutine 
use the USR command— Q = USR(ADR(C$)). This subroutine will move the ROM character 
set into RAM. 

Listing 6-3. Move Player/Missile Up/Down 


L O R E M I... IS TIN G 6 * 3 

20 REM MOVE PLAYER/MISSILE UP/DOWN 

30 rem by l*m*schre:i:ber for tab books 

4 0 DIM IJ P $ (13 ) y D 0 W N $ (13 ) 

50 FOR X»1 TO 13 * READ BJUP*<X r X) =CHR$ < 
B) i NEXT X 

6 0 D A T A 1 0 4 y 1 6 0 r 0 y 2 0 0 r 17 7 y 2 0 5 r 13 6 r 14 5 y 

2 05 y 2 0 0 y 2 0 8 y 2 4 7 y 9 6 

7 0 F 0 R X ~ 1 T 0 13 t R E A D B * D 0 W N $ ( X y X ) ~ C H R 
$ (B)♦NEXT X 

8 0 D A T A 10 4 >• 1 6 0 y 2 5 5 y 13 6 * 17 7 y 2 0 5 y 2 0 0 1 14 

3 y 2 0 5 y 13 6 r 2 0 8 r 2 4 7 y 9 6 

9 0 "? " :>■ C L E A R > 11 y 50 y “ U P $ « " f C H R * (3 4 ) y l F 0 
R X 1 T 0 13 i ? C H R $ < A S C ( U P « ( X y X ) ) ) y i N E X 
T XT? CHR*<34) 

1 o 0 ? 6 0 f 11 D 0 W N $ " 5 0 H R $ (3 4) y f F 0 R X = 1 T 
0 13 J11- A S C ( D 0 W N * ( X y X ) ) > 2 5 2 T H E N ? C H R 


.i. : •••! v A 

:|> 2 / J V 
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1.10 ? C H E $ ( A S C ( D 0 W N $ ( X „ X ) ) ) 0 i N E X T X i ? 
C H E $ ( 3 4 ) t ? 7 0 t ? 8 0 t ? 9 0 t ? 10 0 : ? 110 


Line 40 sets aside 13 bytes each for the two machine language subroutines. 

Line 50 reads the data from line 60 into UP$. UP$ will contain the machine language 
subroutine to move the players up. 

Line 70 reads the data from line 80 into DOWN$. This is the machine language subroutine to 
move the players down. 

Line 90 clears the screen and prints the two strings on the screen with line numbers before 
them. The numbers 70, 80, 90,100, and 110 also appear on the screen. Move the cursor to the top 
of the screen and press the return key 7 times. Lines 50 and 60 will be replaced with the new lines 
that contain the machine language subroutines. Lines 70, 80, 90, 100, and 110 will be erased from 
the program. 

To use these subroutines, store the high order address of the player to be moved in location 
206 and the low order in location 205. Executing either subroutine with the USR command will 
move the player up or down. 

When storing a machine language subroutine in a string, make sure that the subroutine 
contains relative branches. That is jumps that depend on a byte count instead of a firm address. 
The string can be placed anywhere in memory. The location of the string will vary from program 
to program. If the machine language subroutine contained a set jump, for example, jump to address 
2048, the program would always jump to that address. If the correct instruction was there, the 
routine would work properly. If it wasn’t, the program would crash. By using a relative jump, for 
example, Branch Not Equal, the program will be directed to a location by bytes (forward 8 bytes, 
backwards 3 bytes, etc.). This routine could be located anywhere since the same instruction will 
always appear 8 bytes after or 3 bytes before the current instruction. 

RELOCATING THE STRINGS 

In the last chapter, tables for the variables, their names, and the string/array area were 
listed. Knowing where the computer looks to find out where a string is located enables us to be 
able to relocate strings to areas that are more suitable for our program needs. 

The two tables that we will be using in the next program are the variable value table and the 
string/array area. By changing the offset values in the variable value table, we can make the 
computer “think” that the string is located elsewhere in memory. By changing the values in the 
fifth and sixth locations in the variable value table, we can change the length of the string. 

In effect, we can make the screen one string, and manipulate it as such. We could even store a 
program in a string if we had reason to. One example of relocating the strings is in the next 
program. 

STRINGS AND PLAYER/MISSILE GRAPHICS 

The player/missile graphics have provisions for moving the player/missiles to the right or 
left with a simple poke command. But, in order to move the players up or down, we have to rely on 
machine language subroutines. If the player was extremely long (tall), the movement could look a 
little jumpy. In the next program, which simulates a slot machine, we will move the players up by 
manipulating a string. 


101 





Listing 6-4. Player/Missile Strings 


10 

REM 

LI 

ST I 

NG 

2. v 

REM 

PL 

AYE 

R/ 

30 

REM 

BY 

L. ♦ 

My 

40 

DIM 

PI... 

1 $ ( 

1) 

) y 

JGKPT 

’$( 

8 > 


50 

GRAF 

•HI 

CS 

41 


KE 
(3 E 


)#2561 REM GET THE DISPLAY LIST 
6 0 P 0 K E D LIS T+4 5 y 7 0 t P 0 K E D LIS T+4 8 » 6 J P 0 

DLIST+49y6iP0KE DLIST+50 y 6 JREH CHAN 

TEXT WINDOW TO GR. 1 
70 COLOR 1♦PLOT 50 t 37JDRAWTO 50 t St DRAW 
T 0 2 4 y 5 J P 0 SIT10 N 2 4 y 3 7 t P 0 K E 7 6 5 r 1 l X10 
18 y # 6 y 0 r 0 r " S J " J R E M D R A W S L 0 T M A C HIN E 
80 COLOR 0♦FOR X=10 TO 13iPLOT 24 y X l DR 
AWTO 32y X J PLOT 34 y X l DRAWTO 40yX:PLOT 4 
2 y X JDRAWTO 43* X * NEXT X S REM MAKE WINDOW 
90 V ART=PEEK (134 ) + PEEK (135 ) *256 *STT AB* 
P E E K (14 0 ) •{• P E E K (14.1) *2 5 6 J R E M G E T T H E V A 
RIABLE & STRING TABLES 

100 POKE 559y46JREM SET FOR DOUBLE LIN 
E P/M RESOLUTION 

110 P M B A S E :::: P E E K ( 10 6 ) 8 J P 0 K E 5 4 2 79 y P MBA 
SE t REM SET P/M GRAPHICS 2K ABOVE END 0 
F MEMORY 

12 0 P M B A S E - P M B A S E * 2 5 6 J R E M F U I... L A D D R E S S 
OF P/M GRAPHICS 

130 X~0 ? FOR Z-512 TO 768 STEP 128 1 REM 
BEGINNING OF EACH PLAYER 
.1.40 STR0FFSET=PMBASE+Z•••• STTAB ♦ REM CHANG 
E THE OFFSET VALUE FOR THE STRINGS 

15 0 S T R 0 A i... 3= IN T ( S T R 0 F F S E T / 2 5 6 ) t R E M HIG 
H ORDER ADDRESS OF OFFSET 

16 0 S T R V A L 4 ~ S T R 0 F i :: ' S E T 2 5 6 # S T R 0 A L 3 i R E M 
LOW ORDER ADDRESS OF OFFSET 

.1.7 0 P 0 K E V A R T + 2+X y S T R V AI... 4 t R E M T HIR D B Y 
TE FOR STRING VARIABLE IN VARIABLE TAB 
L.. E 

:l. 8 0 P 0 K E V A R T+3 f X y S T R V A L 3 t R E M F 0 U R T H B 
YTE FOR STRING VARIABLE IN VARIABLE TA 
BI..E 

190 POKE VART+4+Xy128 i REM MAKE STRING 

128 BYTES LONG 

200 POKE VART+5+XyO 

210 POKE VART+6 + X y128T REM SET LENGTH T 
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}• v :>•" ? p L :i. $ 


0 128 

220 P0KE VART+7+X y 0 ?X=X+8 ?NE X T ZiREM I 
INCREMENT X FOR NEXT STRING 
2 3 0 P L1 $ ( 1) - " > x }■" ? P L .1. $ (:l. 2 8 )-" > y :>•" ? P I... :l. $ 
< 2 )- P L. 1 $ ? R E M C L E A R T H E S T RIN G 
240 X=36iF0R Z-l TO 54?READ BJPL1*(X»X 
) = CHR$ (B) ? X=X +1?NEXT Z ? JCKPT$=pi... 1 $ < 73 y 
80)JREM GET SYMBOLS 


9 *»; 

A«» \«r 

.... 

J 

y 
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y 
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') 

A- 
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6 y 
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k.) 

y 4 0 
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8 

y 

108 

y 0 

'? 

Am \»r 

!••• 
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0 

y 

0 

y 
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A.. 

4 

y 6 0 

y 

12 

k.) 

y 

60 

y 

'*> 

Am 

4 y 0 


•:> « :: i 

A.. W 

.... 

D 

y 

0 

y 

0 

y 

0 

y 

6 0 

y 

1 

26 

y 

6 
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y 

0 

y 

0 


9 ,:: i 

A*. 

.... 

y 

0 

y 

48 

y 

8 

y 2 

4 

y 

60 

y 

1 

'"i 

A'.. 

6 

V 

z 

k..* 

0 y 0 


r ? 5* 

.... 

1 

y 

0 

y 

0 

y 

0 

y 

12 

6 

V 

12 

6 

y 

0 

y 

0 

y 
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9 

A«« V«» 

5 

y 

/\ 

U 

y 

1 

Z. 

k.) 
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J. (!) y 

O 

y 1 
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A.. 
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y 1 2 

4 y 0 

PL 

1 

$ 

❖ 
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••v 
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:::: 

PL 
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5 3 

'•> 

A*.. 

—> 

/ 


y 

3 

♦ 

P 

OKE 


6 

•"> ".y 

N.) 

y 

4 

<■ 

\' 

R 

F 

M 

ENABLE 


p / M G R A P HIC S - E S T A B LIS H P R10 RITIE S 
3 3 0 P 0 K E 7 0 4 v 9 0 J P 0 K E 7 0 5 y 12 0 ? P 0 K E 7 0 6 r 
3 0: P 0 K E 7 0 8 y .1.5 0?R E M S E T C 0 L 0 R S 
3 4 0 M 0 N E Y - 10 0 ? P 0 K E 5 3 2 4 8 t .1. 0 4 J P (3 K E 5 32 4 
9 y 119 J P 0 K E 5 3 2 5 0 y 13 5 ? R E M FIL L T H E UIN D 
OWS - MOVE THE PLAYERS ON THE SCREEN 
3 5 0 ? " > C L E A R > Y 0 U H A V E $ " 5 M 0 N E Y X ? * P R E 
SS any KEY'S?REM PRINT THE MESSAGE 
360 IF PEEK(764)-255 THEN 360?REM WAIT 
FOR A KEY TO BE PRESSED 
3 7 0 M 0 N E Y = M 0 N E Y - 1 ? P 0 K E 7 6 4 y 2 5 5 ? T « IN T < R 
N D ( . 1 . ) * :l. 5 > + 5 ? R E M PIC K N U M B E R 0 F S PIN S F 
ROM 5 - 14 

3 8 0 F 0 R X -1 T 0 T * 9 ? T E M P $=P L 3 $ ( 3 6 > ? PI... 3 $ 
( 36 y 88 ) -PL3$ < 37 y 89 ) ? PL3$ ( 89 ) -TEMP$ ? REM 
ROTATE THE STRINGS 

3 9 0 F 0 R Z - 1 T 0 2 ? T E M P $ - P I... 2 $ < 3 6 > ? P I... 2 $ ( 3 
6y 88)-PL2$(37 y89)? PL2$<89)-TEMPT? NEXT 


400 FOR Z1 TO 3 ? TE MP T-P L 1 T ( 3 6 ) ? PL1 T ( 3 
6 y 8 8 ) - PI... .1. T ( 3 7 y 8 9 > ? P L. 1 T ( 8 9 > - T E M P T ? N E X T 


Z ? NEXT X 


410 T -1N T ( R N D (1 ) * 6 ) + 6 ? R E M PIC K N U M B E R 
OF TURNS FROM 1 - 6 

4 2 0 F 0 R X = 1 T 0 T >K 9 ? T E M P T=P L 2 T ( 3 6 ) ? P L 2 * 
( 36 y 88 ) - PI...2$ ( 37 y 89 ) ? PL2$ ( 89 ) -TEMPT ? REM 
ROTATE THE FIRST TWO STRINGS 
4 3 0 F 0 R Z=1 T 0 2 ? T E M P T=P I... . 1 . $(36)? P I... 1 $ ( 3 
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Listing 6-4. Player/Missile Strings (continued from page 103) 


TO PLAY AGAIN"5 JR 


THEN 560JREM WAIT 


550 ? ■PRESS ANY KEY 
EM NEXT PLAYER 
560 IF PEEK(764)=255 
FOR A KEY 

570 GOTO 340?REM PRESS SYSTEM RESET TO 
END GAME 

6 ? 8 8 > - P L1 $ ( 3 7 y 8 9 ) ? P L1 $ < 8 9 ) - T E M P * 5 N E X T 
Z? NEXT X 

440 T-INT (RND (1) #6) f-6 ? REM PICK NUMBER 
OF TURNS FROM 1 - 6 

450 FOR X=1 TO T*9 J TEMP*=PL1 * (36) ? PL1$ 

( 36 1 88 ) = PL 1 $ < 37 r 89 ) ? PI... 1$ ( 89 ) - TEMP* ? NEX 

T X ? REM LAST STRING 

455 REM CHECK FOR PAYOFF 

460 IF PL3$(37 v 44)=PL2$(37» 44) AND PL3 

$ < 3 7 y 4 4 ) = P L1 $ ( 3 7 v 4 4 ) A N D PI... 3 $=J C K P T $ T 

H E N MON E Y •- M 0 N E Y+5 0 0 ? S - 7 5 ? G 0 T 0 510 

470 IF PL J. $ (37 y 44 ) ~PL2$ (37»44 ) AND PL3 

*(37 r 4 4)-PL1*(37 r44) THE N M 0N EY-M 0N EY+ 

100J S-100 ? GOTO 510 

4 8 0 IF P L 1 $ C 3 7 v 4 4 ) - P L 2 $ ( 3 7 v 4 4 ) T H E N M 0 

N E Y - M 0 N E Y f 5 0 ? S ® 12 5 ? G 0 T 0 510 

490 IF F'L 1 $ (37 y 44 ) ~PL3* ( 37 v 44 ) THEN MO 

N E Y=M 0 N E Y+5 ? S -• 15 0 ? 6 0 T 0 510 

500 S-200 ? REM NO WIN 

510 SOUND 0 t S 9-1 0 9 10 ? F0R X* 1 T0 M0NEY ? N 
EXT X?SOUND 0 r 0v 0 f 0 ? REM MAKE SOUND TO 
INDICATE WINNING 

520 IF MQNEY>0 AND MQNEYC1000 THEN 350 
? REM CHECK FOR END OF GAME 
53 0 ? ■ > C L E A R > " ? IF M 0 N E Y=0 T H E N ? “ y o u 
1 o s e “ ? G 0 T 0 5 5 0 ? R E M L 0 S T Y 0 U R S HIR 1" 

540 IF M0NEY=1000 THEN ? H Y0U WIN " ? REM 
BROKE THE BANK 

550 ? "PRESS ANY KEY TO PLAY AGAIN“ i ♦R 
EM NEXT PLAYER 

560 IF PEEK<764)=255 THEN 560?REM WAIT 
FOR A KEY 

570 GOTO 340?REM PRESS SYSTEM RESET TO 
END GAME 

Line 40 sets aside one byte for the strings that will be used for the players. TEMP$ will hold 
one byte during the string manipulation. JCKPT$ is the jackpot character. In order for this 
procedure to work correctly, PL1$, PL2$, and PL3$ must be the first three variables in the 
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variable name table. Before typing this program in, turn off the computer; then turn it back on. 
Begin typing in this program. If the computer is given a variable before the PL strings, it will store 
that variable in the table. This will set the PL strings off and the program will not work correctly. 

Line 50 sets the graphics to 4. We will only need two colors for the slot machine, the 
background color and the machine’s color. The beginning of the display list is stored in DLIST. 

Line 60 changes the text window from graphics mode 0 to graphics mode 1. When we are 
using a graphics mode with a text window, the display list will have another load command after 
the proper number of mode commands. This command tells the computer to start a new screen 
display in graphics mode 0. We will change that to graphics mode 1 by poking it with a 70. The 
three lines that would display graphics mode 0 are changed to graphics mode 1 by poking three 
more locations in the display list with a 6. (Graphics mode 1 is ANTIC 6.) Now the text window in 
the program will have large print. 

Line 70 uses the XIO command to draw a slot machine on the screen. 

Line 80 uses color 0 (black) to erase part of the slot machine for the windows. 

Line 90 stores the location of the variable table in VART and the address of the string/array 
are in STTAB. These two values will be used to relocate the strings. 

Line 100 sets the player/missile for double line resolution. 

Line 110 sets the player/missile graphics 2K before the end of memory. The top of memory 
is stored in location 106. By subtracting 8 from it, we are subtracting 2K of memory. The 
beginning of the player/missile area is stored in 54279. 

Line 120 multiplies the beginning address by 256 to arrive at the decimal location of the 
player/missiles. The number that is stored in PMBASE before it is multiplied is the high order 
address. 

Lines 130-220 relocate the three strings that will be used for the player/missile graphics. 
The variable X is set to 0 (zero). This is the variable number or location in the variable table. The 
first player is 512 bytes past the address of the beginning of the player/missile area. Each player 
is 128 bytes apart, so the for . . . next loop uses a step 128. The string offset is stored in the 
variable STROFFSET. This is the value that the computer will add to the address of the 
string/array area to arrive at the location of the string. When the strings are not being relocated, 
the first string will have zeros as the offset since the first string will begin at the first byte of the 
string/array area. The second string’s offset will be one more than the length of the first string. 
The string should begin with the first byte of the player. The value of Z will be added to PMBASE. 
This is where the player begins in the player/missile graphics area. The value of STTAB must be 
subtracted because the computer will “add" this value back when it is looking at the string. The 
value that you arrive at is the new offset for the string. This value is greater than 255, so it will 
have to be divided into two bytes. The high order address is the integer (whole number) of the 
offset divided by 256. The low order address is arrived at by subtracting the high order integer 
times 256 from the address. These two bytes are stored in the third and fourth bytes of the 
variable table for that string. The next two bytes in the variable table indicate the amount of 
memory set aside for the string. We want 128 bytes for each string, so the low order is poked with 
128 and the high order with a 0 (zero). The last two bytes set the length of the string. We want the 
string to be 128 bytes long, so these two locations will be poked with a 18 and 0 (zero). The 
variable X is incremented by 8 because the information for the next string will begin 8 bytes down 
from the beginning of the information for this string. This routine is repeated two more times. 
When it is finished, the first three strings in the variable table will be 128 bytes long and their 
location will be the player/missile graphics area. 
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Line 230 clears the first string. 

Line 240 reads the data in the next 6 lines and stores it in the string. This data will draw the 
cherry, orange, lemon, apple, gold bar, and bell into the plaver/missile graphics are. The string 
JCKPT is set to the 5th character in the string. 

Line 310 sets the other two strings. 

Line 320 pokes location 53277 with a 3 to enable the players, and location 623 is poked with a 
4. This establishes the priorities of the players and the graphics on the screen. If the priorities 
were not set, some of the players would appear over the machine instead of inside it. 

Line 330 sets the colors of the slot machine and the three wheels. 

Line 340 sets the variable MONEY to 100. This is the amount of money you have to start the 
game. The three players are moved on the screen by poking their locations into the correct 
registers. 

Line 350 prints a message in the text window. 

Line 360 checks location 764 for a value other than 255. When the value of this location 
changes, then a key has been pressed. 

Line 370 subtracts one dollar from the amount of money left. The key location is cleared, and 
a random number from 5 to 19 is chosen. This number determines the number of times the 
rightmost wheel will spin. 

Lines 380-400 make the wheels spin. This works on the same principle as the boat in the first 
program of this chapter. The top character of the string (in this case it’s in the 36th location) is 
removed from the string and stored in a temporary location. The rest of the string is moved up one 
byte. The character that is being stored in the temporary location is moved to the end of the 
string. Each of these strings is a different player. The rightmost wheel is rotated once, the middle 
one twice and the leftmost three times each time the program executes the loop. This gives the 
illusion of the wheels spinning at different speeds. 

Lines 410-450 spin the middle and leftmost wheel after the right wheel stops. Each wheel is 
spun a few more times after one wheel stops. 

Lines 460-500 check for a payoff. If all three characters shown on the machine are the same 
and they are the bars, the jackpot is won. 500 is added to the amount stored in MONEY. If the 
three are the same, but not the jackpot, 100 is added to the amount stored in MONEY. If the first 
two characters are a match, 5 is added. If there are no matches, nothing is added to the amount in 
MONEY. 

Line 510 makes a sound to indicate the win. The variable S is set to a different value 
depending on the amount of MONEY won. This line generates the sound. 

Line 520 checks the variable MONEY to see if you can still play.If there is no MONEY, or 
the value of MONEY is greater than 1000, the game ends. 

Line 530 clears the screen and prints you lose if you have no money left. 

Line 540 prints you win if the amount in MONEY is greater than 1000. 

Line 550 prints the message on the screen. 

Line 560 waits for a key to be pressed. The program will loop here until a key is pressed, if 
the system reset key is pressed, the program will end. 

Line 570 sends the program back to line 340 to play again. 
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Chapter 7 

Display 

List Interrupts 


An interrupt is a subtle way to get the computer to do a task while it appears to be doing something 
else. When you are working on a program with your ATARI, the computer looks like it is just 
sitting there waiting for you to enter your new line or command. What is actually happening is the 
computer is very busy maintaining several areas. The ANTIC chip keeps the information on the 
screen; the clock keeps time; and the computer keeps checking to see if it’s time to start the active 
mode. When you press a key, you are interrupting the 6502. It now checks which key was pressed, 
and sends that information over to the ANTIC chip so that it can be displayed on the screen. 
Because of the speed at which the computer works, this appears to be done instantaneously. The 
computer is capable of handling more functions if it is interrupted at the proper times. 

HANDLING AN INTERRUPT 

One of the best times to interrupt the computer is when it is drawing on the screen. To draw 
an image on the screen, the computer must be synchronized with the raster scan of the television 
set. This happens within the computer and we do not have to be concerned with it. When the 
raster scan begins to draw a picture on the screen, it begins with the upper left corner and goes 
across the screen to the upper right corner. When it is finished with the line, it shuts itself off, 
retraces its line, then drops down one line and turns itself back on. It continues to draw lines, turn 
itself off, retrace, drop down, and turn itself back on until it reaches the bottom of the screen. 
There it will shut itself off and return to the top of the screen, where it will begin to draw all over 
again. 

The period of time during which the raster is turned off and is retracing the line is called a 
horizontal blank. The period of time needed for the raster to go back to the top of the screen is 
called the vertical blank. During this time we can interrupt the computer and have it do something 
that we want it to do: something that may not be possible in BASIC or machine language alone. 

There are certain registers or memory locations in your ATARI that seem to have a double in 
ROM. The color registers are one set of these registers. There are 9 different locations to store 
the color values in RAM. There are also 9 color locations in the ROM or Operating System. If you 
poked a value into the RAM locations, you would change the color of the character on the screen. 
If you poked a value into the corresponding ROM location, nothing would happen. 

ANTIC draws characters on the screen based on the colors in the ROM locations (these 
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Table 7-1. Hardware Registers and Shadows. 



locations are also called the hardware registers). Each time the vertical blank occurs, 60 times 
every second, the computer looks at the colors in the RAM locations and stores them in the 
hardware registers. If you poked a color value into a hardware register, it will be replaced within a 
60th of a second! Table 7-1 shows a list of hardware registers. The second location is called the 
shadow register. This is the register that contains the value that will be placed in the hardware 
register by the computer during the vertical blank. 

There is a way to change a value in the hardware register without interference from the 
shadow register: interrupt the display list and change the value during a horizontal blank. 

WRITING SERVICE ROUTINES 

During the period of time that the raster scan is retracing itself, the computer is free to do 
other things, like change colors, character sets, or other images on the screen. To do this, 
however, the computer must be told to watch for an interrupt. In the following program, the 
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computer is told that there will be a display list interrupt. The correct bit is set for an interrupt at 
the end of a line, and the colors in color registers are changed. 

The only problem with using a display list interrupt to change the color value is that the 
character will always be one color above the line and the other color below the line. If the 
character travels above the line it will be changed to the original color. 

Listing 7-1. Color Service Routine 


0 REM LISTING 7.1 
0 REM COLOR SEEVI 
0 REM BY L.M.SCHR 
0 GRAPHICS 18 
0 DL=PEEK(560)+PE 
REM THE 5TH LINE 
0 POKE Dl...y PEEK COL 
i b i t t o 1 b '-j s d d :i. 

that location 
0 FOR ML=1536 TO 
t NEXT ML:REM POKE 


CE ROUTINE 

FIBER FOR TAB BOOKS 


E SUBROIJT 
90 POKE 5 
2 i REM ADD 
OIJTINE - 
100 DATA 
8v169v88.» 
2 0 8 y 14 0 y 2 
120 POSIT 
13 0 P 0 SIT 
160 POSIT 
POSITION 
170 GOTO 


I NIL" INTO 
12y 0:POK 
RESS OF 
ACTIVATE 
72 y138 y 7 
1 4 1 y 1 0 y 2 
2y208y10 
2 y 1 t 
2 y 3 t 

2.9? t 
? *6 


ION 
10 N 
ION 

”7 ("i •> 

/ y / <• 

170 


EK<561>*256JDL=DL+10 
ON THE SCEEN 
)+128:REM set the 8t 
ntl 1.28 to the peck o 

.1564 % READ Q t POKE ML y 
THE MACHINE LANGtJAG 
FREE RAM 

513 y 61 POKE 54286y19 
ACHINE LANGUAGE SUBR 
INTERRUPT 

y 1 5 2 y 7 2 y 16 2 y 10 0 y 16 0 y 
2 y141y 2 4 y 208 y142 y 23 y 
y 1 6 8 y 10 4 y 1 7 0 y 1 0 4 y 6 4 
16 y " B I... U E " y " d r e e n " 

#6 y"red"y"YELLOW" 

#6 y"PINK"y“purple "l 
" GRE Y “ 


Line 50 changes the graphics mode to 18—mode 2 without the text window. 

Line 60 stores the beginning of the display list in variable DL. The address of the beginning 
of the display list is stored in locations 560 and 561. To arrive at this address, the contents of 
memory location 561 must be multiplied by 256 and the contents of memory location 560 must be 
added to this product. Add 10 to this address to point to the middle of the display list. 

Line 70 changes the display list. By setting the high order bit of a display list value to 1, we 
tell ANTIC that after it draws or writes this line onto the screen, there will be an interrupt. Since 
we may not be sure what the value might be at this particular location, the simplest way to set the 
bit is to add 128 to the value of this location. 

Line 80 reads the data from line 100 and pokes it into the free RAM beginning at location 
1536. See Table 7-2 for the assembly language listing of the subroutine. 

Line 90 stores the address of the beginning of the interrupt routine at memory locations 
512-513. The address, in this case 1536 is divided by 256. The high order address is the integer 
part of the quotient. 1536/256=6. There is no remainder. The 6 is stored in memory location 513. 


109 







Table 7-2. Service Routine to Change Colors. 


d 0 c :i. di 3 .1. c o d s 


-—I 


z c* 

I I I 


:i. o o 
:l. 6 o 


Q 

c “* 


16V 


o 


141 


u 


IM 


’ \ .* A 
V .* % 

/\ H 


•; s s 0 m b 1 v 1 a n a u a b e .'I. :i. s t :i. n d 

? P i..i s h a c e Li H i li 1 a t a r o n t h e s t a e k •> 

? T r a n s f e r :i n d e x X t o a e e u in li I a t □ r 


...J 

PM A 


;.i 

Push 3 CCL 

i m u 1 31 o r 

O I 'i :::• 





o n t e 11 1 s 


1 




1. 

l- i • 3 1 i 3 1 0 

r r 0 o 

v.v •••» 

TY A 


y 

] r 3 n s ! 0 r 

:i. r i d 0 x Y 

t O 3 

.... n 
/ rf.. 

PH A 


A 

M 

li h 3 c c l 

i m li .1.31 o r 

o ri s 




( 

C D I’ I b 0 I’ i t :::• 

t P 3 1 ”l S f 0 

r r 0 d 


LUX # 

| 0 0 

•I 

!... I..' 3 U .1 1 ! :..i (•: 

?x X wit 

n .1. (j v 


3 c K 


from index Y) 


L D Y ; ll : 8 5 L o 3 d :i. r"i d e x Y w :i. t 8 •> 


I'i A # 8 8 ? L a 3 d 3 c c li in u 131 o r w :i. t h 8 8 •> 


8TA 54282 ?Store the contents of the 

a e c li iti u I t o r- t t h i •:> 3 d d r e s s ri d 


If there was a remainder, it would be stored in location 512. Since there is none, a zero is stored 
there. Memory location 54286 is poked with 192. This is a hardware address that can enable the 
interrupt for the display list interrupt and the vertical blank interrupt. If it is not enabled, ANTIC 
would ignore the code in the display list that tells it that this is the place where it should execute 
the interrupt routine. 

Lines 120-160 print on the screen. The first four words—blue, green, red, and yellow use the 
colors that are preset by the operating system. Be sure that BLUE is in uppercase and inverse, 
and red is lowercase inverse. Each word will appear in its color. The three words on the bottom 
will appear in new colors. PINK is uppercase inverse, and appears pink on the screen. Purple and 
GREY were previously green and YELLOW. The interrupt routine changed the color code in the 
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hardware register during a vertical blank. The operating system replaced the color with the color 
code from the RAM shadow address during the horizontal blank. Everytime something is printed 
on the top half of the screen, it will appear in the color set by the operating system, or the color 
that was placed in the shadow registers under program control. The colors on the bottom half of 
the screen will be the colors forced into the hardware registers during the interrupt. 

End this program by pressing the system reset key. 

Changing the colors in a program is only one possible use of interrupts. Any feature that has 
both a shadow or RAM address and a hardware address can have multiple uses with the interrupt. 
In the next program we will use two character sets in the same program. The standard character 
set will be displayed at the top of the screen, and the new characters will be used at the bottom. 
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Listing 7-2. Double Character Sets 


10 

REM 

!... IS 1 IN B 

7 n 




2 0 

REM 

DOUBLE 

CHARACTER 

: SET 

S 

3 0 

REM 

BY L»Ht 

SCORE 

IBER 

: FOR 

TA 

4 0 

GRAF 

HICS 0 





50 

CB“P 

EEK(106 

) -8 ♦ P 

OKE 

204 x 

cb: 

x 2 

24 1 RE 

M PLACE 

NEW 

CHARACTE 

RS 

END OF 

MEMORY 

0 




60 

FOR 

ML®1536 

TO 1 

!••• 1"' !••• A 
1.. ■ 1- ▼ 

\.J •..) ♦ 

READ 

Q ; 

q: 

NEXT 

ML 1 REM 

MOVE 

THE 

MACHINE 

TO 

RAM 
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Q*US 

R (1536) 

J REM 

NOW 

RUN 

IT 

8 0 

DATA 

104x16 

2 x 2 x 1 

6 0 y () 

x 17 7 

x 20 

•*y 

y 

200>2 

08 x 249 x 
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r> 

Am 
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A. 
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6 
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a t 

NEXT 


V 

A 













100 

DATA 
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y 
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y 
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y 
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5?REM ADD SERVICE ROUTINE IN MIDDLE OF 
DISPLAY LIST 

1 7 0 P 0 K E DI... r P E E K ( D I...) +12 8 i R E M S E T BIT F 
OR INTERRUPT 

.1.80 FOR ML-IS36 TO 1.546 i READ 01 POKE ML 
* 0 1 N E X 1" M I... 1 P 0 K E 1.5 3 8 y C B i R E M P 0 K E T H E M 
ACHINE LANGUAGE SUBROUTINE INTO RAM 
1.9 0 l :: ' 0 K E 51.2 v 0 1 P 0 K E 51.3 y 6 t P 0 K E 5 A 2 & 6 y 1. 
9 2 1 R E M A D D R E S S 0 F M A C HIN E I.. A N G U A G E S U B 
ROUTINE ~ ACTIVATE INTERRUPT 

2 0 0 D A T A 7 2 y 1.6 9 y 1.5 2 y .1.41. y 1.0 y 21.2 y 1.4.1. y 9 y 2 
1.2 y 1.0 4 y 6 4 

21.0 P 0 SIT10 N 9 y 2 1 ? " S I " A N D A R D C H A R A C "I" E R 


(-• II 


2 2 0 P 0 SIT10 N 1 3 r 15 J ? " B 0 L D F A C E " 
300 GOTO 300 


One of the first tricks that everyone learns is how to turn the screen upside-down by poking 
755 with a 4. (If you’ve never tried it, do it now with the direct command: 


POKE 755,4 

(If you have a program listed on the screen, it will look most impressive!) 

This is fine if you want everything to be upside down. But, maybe, you want just one or two 
lines in the middle of the screen turned for a mirror effect. Again, the interrupt routines can be 
used to do it right on cue! 


Listing 7-3. Mirror Images Routine 
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Line 40 sets the graphics mode to 0. This command will make the computer reset the entire 
display list. By having the display list reset, we can run this program several times. If the display 
list was not reset, line 70 would produce an error message. 

Line 50 finds the beginning of the display list and stores this address in the variable DL. We 
add 15 to this address so that we will be working with the middle of the display list. 

Line 70 sets the eighth bit of the byte in the display list. By adding 128 to the value found at 
this location, we set only one bit without disturbing the original value. 

Line 80 reads the machine language subroutine that inverts the letters. 

Line 90 pokes the address of the machine language subroutine into memory locations 512 and 
513. 192 is poked into location 54286 to tell the computer that an interrupt will be generated. 

Run the program. Now list the program. The listing on the top half of the screen will be 
correct. The listing on the bottom half of the screen will be inverted. Press the system reset key 
to turn the screen back to normal. 

PRECISE TIMING 

Another use for a service routine is for precise timing. The routing will be executed every 
time the computer comes to that line in the display list. Since the display list is synchronized with 
the raster scan on the television, the routine will be executed every l/60th of a second. By placing 
a counter in the routine, a character can be moved, a sound can be made, or a color changed 
precisely on schedule. 

In the following program, the neon sign is kept flashing with an interrupt service routine. 


Listing 7-4. Precise Timing 
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Line 40 sets the grapics mode to 0. This must be done at the beginning of the program 
because you will be adding a value to an existing value in the display list. By setting the graphics 
mode at the beginning of the program, the computer reinstates the original value into the display 
list. If this wasn’t done, and the program was rerun, the computer would be adding a value to the 
value that was changed in the previous run. Poking 752 with a 1 removes the cursor from the 
screen. 

Line 50 finds the beginning of the display list and sets the variable DL to the 2nd line or the 
7th value in the display list. 

Line 70 gets the value from the display list and adds 128 to it. The new value is poked back 
into the display list. This is the line that the graphics were set back to zero for. 

Line 80 reads the machine language subroutine into memory. This is the routine that the 
computer will execute during the interrupt. 

Line 90 pokes the memory location 206 with a zero. We will be using this location as a 
counter for this program. 

Line 100 and 120 use the position command to erase the cursor that was left there by the 
graphic 0 command. The plot and DRAWTO commands draw a rectangle on the screen. The 42 
after COLOR is the character that will be drawn. In this case, it will be an asterisk (*). 

Line 110 draws another rectangle between the first and second rectangle. 

Lines 130-150 print the message inside the sign. The words COLOR, WATER, and LOW 
PRICE are in inverse video. 

Line 190 tells the computer where in memory the service routine is located and tells the 
computer that there will be an interrupt. 

Line 200 contains the data for the machine language subroutine. This subroutine uses the 
clock to find out when the words should be turned on and off. See Table 7-3 for the assembly 
language listing for this program. 

To end this program, press the system reset key. 

Listing 7-4A. Precise Timing—Second Method 
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Table 7-3. Service Interrupt to Flash Inverse Characters. 
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Listing 7-4A. Precise Timing—Second Method (continued from page 115) 
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This listing is nearly identical to the previous one. The difference is in the data line. In the 
first program, the value in location 206 was “or’d” with 1. The value was stored in 54273. By 
alternating this value between a 1 and a 0, we turn on the characters that were printed in inverse 
video. In the second program a zero is stored in this location. Now the computer will print the 
same characters in inverse video, then normal video. 


PLAYER/MISSILE ENHANCEMENTS 

In a previous chapter, the player/missile graphics were described as a band that fit over the 
screen. This band could be moved to the right or left by poking a location with a value. In the next 
program we will use the service routine to continually move a player on the screen. 

Listing 7-5. Moving Players 
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Listing Listing 7-5. Moving Players (continued from page 117) 
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Line 50 sets the graphics mode to 0. This is done at the beginning of the program because a 
value will be added to an existing value in the display list. By setting the graphics mode at the 
beginning of the program, the computer reinstates the original value into the display list. If this 
wasn’t done and the program was rerun, the computer would be adding a value to the value that 
was changed in the previous run. 

Line 60 finds the beginning of the display list and sets the variable DL to the 2nd line or the 
7th value in the display list. 

Line 70 gets the value from the display list and adds 128 to it. The new value is poked back 
into the display list. This is the line that the graphics were set back to zero for. 

Line 90 finds out how much memory is in the system and subtracts 2K from it. This places the 
player/missile graphics before the display list. 

Line 100 pokes the beginning location of the player/missile area into 54279. That amount is 
multiplied by 256 to get the actual location of the beginning of the player/missile area. 

Line 110 sets the resolution to single line resolution and tells the computer to enable the 
players/missiles. 

Line 130 clears out the memory area that will be used by the player. If this memory is not 
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cleared, the player could contain random bits or the data from a previous program. This clutter 
would appear on the screen when the player is moved onto the screen. 

Line 130 reads the data that makes up the boat into the player/missile graphics area. 

Line 140 is the data for the boat. 

Line 150 sets the color of the boat, the background color of the screen, and sets the location 
of the boat on the screen to zero. Memory location 205 will be used as a shadow location for 53248. 
The value in 205 will be changed by one each time the computer executes this subroutine. This 
value will then be stored in location 53248 by the service routine. Every time this value changes, 
the boat will move on the screen. 

Line 170 reads the values for the machine language routine and stores them in RAM. 

Line 190 tells the computer where in memory the service routine is located and tells the 
computer that it will have an interrupt. 

Line 200 is the data for the machine language subroutine. 

To end this program press SYSTEM RESET. 

When you use any service routine in program, keep in mind that the computer will execute 
the routine continually until the system reset key is pressed. If it is used with a BASIC program, 
the program can be processing information, waiting for an input, or drawing on the screen while 
the service routine performs its functions. In effect, you are running two programs at the same 
time. 
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Chapter 8 



Scrolling is a technique that moves the contents of a screen up, down, left, or right. When the 
screen appears to move up or down, the movement is referred to as vertical scrolling. When it 
moves left or right, the movement is referred to as horizontal scrolling. Either the entire screen 
or selected lines can move. 

Text adventure games usually scroll the bottom part of the screen, while the top part 
remains the same. The text appears to disappear just under the dotted line. Space games often use 
both horizontal and vertical scrolling. The entire galaxy moves to the left or right, up or down, 
depending on the direction of the joystick. This gives the illusion of a larger playfield and adds 
realism to the game. 

There are two methods of scrolling on the ATARI computer. The course vertical scroll 
moves information up or down one line at a time. The entire screen moves up or down. If there is a 
lot of information on the screen, the movement could appear jumpy. The course horizontal scroll 
moves every line to the left or right one byte. Again, moving the entire screen could make it 
appear to roll. It does not look smooth. 

Fine vertical scrolling moves the line up or down by one pixel. As each line moves up, the 
line beneath it also moves up. The movement is much smoother than the course scroll. The fine 
horizontal scroll moves the line to the left or right by one pixel. 


COURSE SCROLLING 

In a previous chapter we looked at the display list. The fifth and sixth bytes of the display list 
tell the computer where the screen memory begins. If this value were changed, the screen display 
would be different. In the next program, you will print a message on the screen. The message is 
too long to be displayed on the screen all at one time. You could print part of it, have a timing loop 
in the program, and then print the rest of it, but in this program the entire message is printed on 
the screen slowly. The message scrolls from the bottom of the screen to the top. It is not difficult 
to read, although it is a bit jumpy. 

Listing 8-1. Course Vertical Scroll 
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Listing 8-1. Course Vertical Scroll (continued from page 121) 
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Line 40 sets the graphics mode to 0. This is done because you will be poking a value based on 
the peek of a location in the display list. If the value has already been changed and the program is 
run again, the results on the second run may not be the same as on the first run. 

Line 50 finds the beginning of the display list. 

Line 60 changes the value of the fourth byte of the display list (the first byte is DLIST+O). It 
will now be graphics mode 2. 

Line 70 changes the rest of the display list to graphics mode 2. This mode uses 16-pixel rows 
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instead of 8-pixel rows like modes 0 and 1. Since only 12 rows will be displayed on the screen at 
one time, half of the display list will not be seen. 

Lines 80 - 240 print the message on the screen. There are 17 rows of text. Since we changed 
the mode by changing the display list, the computer will try to place 40 characters on a line. Each 
line that we are printing is less than 20 characters. The text will appear double spaced on the 
screen. All 17 rows of text will be placed in the area of memory set aside for the screen display. 

Line 300 finds the beginning of the memory set aside for the screen. The two bytes are 
stored in variables SCRLOW and SCRHI 

Lines 310 - 350 scroll the message on the screen. Line 310 begins the for . .. next loop that 
will move the beginning byte of the screen display area 11 times. 40 is added to the value in 
SCRLOW. This is the low order byte of the beginning of the screen display area. We add 40 so that 
we can move 2 screen rows at the same time. Line 320 contains a timing loop. If we did not slow 
down this routine, the lines would be printed so fast that we could not read them! Line 330 checks 
the value of SCRLOW. If it is greater than 255, it will be reduced by that amount, and SCRHI will 
be increased by 1. If we didn’t increase SCRHI by 1 every time SCRLOW reached 255, the 
computer would stay on the same page of memory. Line 340 changes the beginning of the screen 
memory by changing the contents of the memory locations that ANTIC looks at to start displaying 
information on the screen. Line 350 continues the for . . . next loop. 

To return to the text mode, press the system reset key. 

The next program prints every character that the computer is capable of printing in the color 
text mode. Every line contains all 256 characters, but only 20 characters can be displayed on the 
screen at one time. How can every line contain 256 characters? Remember that the fourth 
instruction in the display list tells ANTIC the mode of the top line and that the next two bytes 
contain the beginning of the screen memory. If we change the display list so that every line starts 
its own screen memory, we can make the lines as long or as short as we need. Each line can be in a 
different mode, or they can all be in the same mode. The next listing prints all the characters in the 
same mode. The one following it uses mixed modes. 

Listing 8-2. Course Horizontal Scroll 


10 

R 

EM 

L 

I ST I 

N 

G 

8 

* 

A*.. 






20 

R 

E M 

c 

0 U R S 

E 


HO 

R 

I 

••v 

ONTAL 

s c 

ROLL 


30 

R 

E i v i 

B 

Y L •> 

M 

* 

s c 

H 

R 

E 

IBER F 

0 R 

TAB 

BOOKS 

4 0 

P 

0KE 


b b y y 

0 

•> 

A 

RE 

M 


T 

URN OF 

F 

ANTI 

c 

Li 0 

S 

ORE 

E 

N •- P E 

E 

K 

( 1 

0 

6 

) 

- 12: RE 

M 

THE 

SCREEN 

W11. 
M n i: 

.1... 

V 

BE 

G 

IN 1 

n 

A*.. 


PA 

6 

E 

b 

FROM 

THE EN 

D OF ME 

1 I U 1 

60 

V. T 

D 

LIS 

T 

-SCR 

E 

E 

NY 

•) 

A*.. 

5 

•...• 

-50 1 RE 

ii 

STAR 

T THE D 

ISF 

'' 1... 

AY 

L 

:i: si 

b 

0 

B 

*. / 
r 

T 

E 

S BEFO 

RE 

T H E 

SCREEN 

70 

F 

OR 

X 

"=0 T 

0 


•••> * 
A*.. «• 

p 

0 

K 

E DL IS 

T+ 

X t X1 

2 t NEXT 

Xit 

T 

<E 

M F 

I 

R S T 

T 

H 

RE 

E 


B 

YTES OF 

D ISP 

LAY LIS 

1 

8 O 

F 

0 R 

X 

= 1 T 

0 


12 

A 

<• 

R 

E 

M TO EL 

OE 

LIN 

ES DISP 

LA' 

(E 

D ON 

THE 


S 

C R 

E 

E 

N 





90 

P 

0KE 


DL IS 

T 

■}■ 

"X O' 

X 

y 

"7 

/ 

1 t REM 

MODE 2 



123 






Listing 8-2. Course Horizontal Scroll (continued from page 123) 


100 

POKE 

DLIST+3*X 

+ 

1V 0 

i REM LOW 

ORDER 

A 

DDRE 

SS OF 

SCREEN L 

INE 




110 

POKE 

DLIST+3*X 

•f 

i it 

V s.t 

CREENf (X -• 

1 ) : R E 

M 

HI OH 

ORDE 

R ADDRESS 


OF 

SCREEN LINE 


120 

NEXT 

V 

/\ 






130 

POKE 

DLIST+X#3 

ii 

'..J * 

REM JUMP 

INSTRUC 

TION 

TO B 

EGINNING 

OF D 

ISPLAY LI 

ST 


140 

D L HI - 

INT(DEIST/ 

/", !••• / 

) '•*, iti 

y.J K.} 

)JDLLO=DL 

IS T ( 

D 1... 

HI #25 A) 







150 

POKE 

DEIST IX*3 

.1. 

l 

1 y DLLO 



160 

POKE 

DLIST+X*3 

.A. 

l 

2 y DL.HI 



170 

POKE 

560 v DLLO $ 

P 

OKE 

561iDLHI 

JREM 

PU 

T TH 

E NEW 

DISPLAY 

L 

IS T 

ADDRESS 

INTO 

IT 

S RE 

GISTE 

RS 






180 

POKE 

88 r 05 POKE 


89 t 

SCREEN i RE 

M TEL 

L 

THE 

OPERA 

TING SYST 

E 

M WHERE THE 

SCREE 

N 

BEG I 

NS 







190 

POKE 

559 t 34 JRE 

M 

TURN ANTIC 

BACK 

0 N 

200 

POKE 

82 r 0 t REM 

e 

TAR 

• Ml • •••• • 1 1*** 

1 A 1 ) IT E 

EDGE 

OF 

THE 

SC RE 

EN 






2 .1. 0 

• j> II II 







v ':> o 

/•II Mil \l 

DIM A 

<|> ( 2 5 6 ) 



• 



230 

FOR X 

1 T 0 2 5 6 

♦ 

A $ ( 

X v X ) :::: CHR$ 

( X •••• 1 ) 

JN 

E X T 

X 







240 

FOR Z 

~ 0 T 0 11 J 

d i s p 

1... A Y :::: ( S C R E 

E N Z ) 

•1' A*.. 

5 6 i l ;: 

0 R X = 

0 TG 255 ♦ 

P 

OKE 

DISPLAY! 

X y ABC 

(A 

$ ( X+ 

1 v X +1 

))J NEXT X 

* 

N E X 

T Z 



2 5 0 

FOR Z 

:=0 TO 235 

•> 

* 

FOR 

x~ 1 to :l. 

2 J REM 

L 

E A V E 

20 C 

IIA R A C T E R S 


ON 

THE SCREE 

N ~ 1 

n 

LINE 

S ON 

SCREEN 






260 

P 0 K E 

DLIS T f X >K 3 

.A. 

i 

1 V Z 

JREM POKE 

THE 

1... E 

E ) M A R 0.1. N 

INTO THE 


LOW 

ORDER SC 

REEN 

AD 

DRES 

S FOR 

EACH ROW 






270 

NEXT 

X : NEXT Z t 

R 

E M 

D 0 E N TIR E 

SCRE 

EN 

280 

FOR Z 

-235 TO 0 


S T E 

P -1:FOR 

x~:i to 

:l 2 : r 

EM DO 

IT BACKWARDS 




290 

POKE 

DLIST+X*3 

+ 

1 r 2 

JREM POKE 

THE 

LE 

FT MARGIN 

INTO THE 


LOW 

ORDER SC 

REEN 

AD 

DRESS FOR 

EACH ROW 






300 

NEXT 

XJNEXT ZJ 

R 

1::. M 

DO ENTIRE 

SCRE 

EN 

310 

GOTO 

250JREM K 

E 

E P 

DOING IT 




Line 40 turns off ANTIC. Since we are making major changes to the display list, it is a good 
idea to turn off ANTIC. Otherwise we could confuse or lock up the computer. 
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Line 50 finds the amount of memory available in the system and subtracts 12 from it. This 
will give us 12 pages or 3K of memory for the screen display. 

Line 60 subtracts 50 bytes from the beginning of the screen area. That should be enough for 
the display list. 

Lines 70 - 160 set up the new display list. Line 70 pokes in the values for the first three bytes 
of the display list. Lines 80 - 120 set up the main body of the display list. There will be 12 lines on 
the screen. Instead of poking in the value for that line of the display list, we need to do more. 
First, we will offset the value of X by multiplying it by 3. Three is used because there are 3 values 
that must be poked in for every line. The first value is 71; this is the same value that would 
normally be placed in a display list for mode 2. It means that the line is in mode 2. The next 2 bytes 
indicate the beginning of the screen display area. The next value to be poked in is a zero. Every 
line will begin on an even page of memory. The next value is the high order byte for the screen 
display area. The line number minus one is added to the value of screen. The jump instruction for 
ANTIC is poked into the end of the display list along with the two byte address for the beginning of 
the display list. Now ANTIC will know where to jump when it gets to the end of the display list. 
The new values for the location of the display list are placed in memory locations 560 and 561. 
ANTIC is turned back on and the left margin of the screen is changed to 0. 

Line 210 clears the screen. 

Line 220 sets aside 256 bytes for A$. This string will be displayed in every line on the screen. 

Line 230 places the character for every value from 0 to 255 into A$. 

Line 240 calculates the beginning of the screen display area for the line by multiplying the 
value of SCREEN plus Z by 256. The ASC (ATASCII) value of every character in A$ is poked into 
this memory area. 

Lines 250 - 270 change the value in the low order byte of the screen display area for every 
line. This makes the rows on the screen appear to move to the left. 

Lines 280 - 300 reverse the process. By subtracting one from the low order byte of every row 
displayed, the screen will shift to the right. 

FINE VERTICAL SCROLL 

The fine vertical scroll is achieved by moving the characters on a line up or down one pixel at 
a time. After the first line has been scrolled as far as possible, the scrolling to the next line is done 
the same way it was done in the course scroll program. 

Once again, the display list plays an important part in the fine scroll. The sixth bit of the byte 
that tells ANTIC what mode the line is must be set in order to scroll that line. An easier way is to 
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add 32 to the mode. If the screen is mode 0, the display list has 2 for the mode. Change the 2 to 34 
and that line can scroll vertically. 

Of course, the line will not scroll all by itself. The computer must be told when to scroll that 
line and how far to scroll it. 54277 is poked with a value from 0 to 7. A zero holds the character in 
the position that it would be in if there was no scroll. A seven moves the character up seven pixels. 
It is almost in line with the correct position for the line just above it. Figure 8-1 shows the 
character position from 0 to 7. 

The following program uses the fine scroll with the course scroll to move a message up on 
the screen. 


Listing 8-3. Fine Vertical Scroll 
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Line 40 resets the display list every time the program is run. 

Line 50 finds the beginning of the display list. Every byte that tells ANTIC the mode of the 
line must be changed. The 6th bit of the byte must be set to 1. 

Line 60 sets the top line of the screen for the scroll. This byte also tells ANTIC that the next 
two bytes are where the screen memory begins. 

Line 70 sets the rest of the bytes in the display list for the vertical scroll. 

Line 80 sets the position on the screen where the message will begin to be printed. 

Lines 170 - 240 print the message on the screen. The entire message will not be printed on 
the screen since this is graphics mode 2. The display list is as long as it would be in mode 0, so part 
of the message will be printed out of the screen area. 

Line 290 sets the variable SCRLOW to the low order address of the screen and SCRHI to the 
high order address of the screen. 

Lines 300 - 350 scroll the message on the screen. Line 300 begins the for ... next loop. 20 is 
added to the value in SCRLOW because there are only 20 characters displayed in a line on the 
screen. If the value of SCRLOW exceeds 255, the value is reset by subtracting 255 from it, and 1 is 
added to the value of SCRHI. This will give ANTIC a new page to display on the screen. If SCRHI 
was not incremented, ANTIC would only display 1 page of screen memory over and over again. 
Line 330 begins the fine vertical scroll. A value from 0 to 7 is poked in memory location 54277. 
After each poke, there is a timing loop. This will slow down the process of scrolling and make the 
text more readable. Once the lines are scrolled up as high as they can go, we shut off ANTIC, poke 
54277 with 0 to reset the scroll or put the line back to normal, and poke the display list with the 
new screen values. This is the course scroll. Because ANTIC is shut off, it will be a smooth scroll. 
ANTIC is turned back on and after another timing loop, the program continues with the original 
for....next loop. 

When the entire message has scrolled up the screen, the program will end. Press the system 
reset key to return to the text mode. 

When you want a message or characters to move down on the screen, the process must be 
reversed. The characters must be brought down one line by the course scroll, scrolled all the way 
up to the top of that line, then slowly scrolled down on the screen. A downward scroll is not always 
as smooth as an upward scroll. 

Listing 8-4. Fine Vertical Scroll: Down 
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Listing 8-4. Fine Vertical Scroll: Down (continued from page 127) 
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Line 40 resets the graphics to mode 0. This restores the display list to its original contents. 

Line 50 finds the beginning of the display list. 

Line 60 sets the fourth byte of the display list for the vertical scroll and graphics mode 1. 

Line 70 sets the rest of the lines in the display list for graphics mode 1 with the bit set for the 
vertical scroll. 

Line 80 begins printing the message on this line. 

Line 90 sets the variable SCRLOW to 244. This figure was calculated by printing the value of 
SCRLOW at the end of the last program. The variable SCRHI should remain the same value as the 
high byte address in the display list. Change the display list low order byte for the screen address. 

Lines 170 - 240 print the message on the screen. This time the entire message will be visible 
on the screen. 

Lines 300 - 350 scroll the message down on the screen. This time 20 is subtracted from the 
beginning of the screen memory. By subtracting 20, ANTIC starts to display the screen area 20 
bytes before the point where the message begins. This pushes the message down one line on the 
screen. 

Line 330 shuts off ANTIC while the new screen memory values are poked into the display 
list. ANTIC is turned on and the screen displays the message one line lower. By poking memory 
location 54277 with 7 to 0, we start the scroll with the lines scrolled up as high as possible. They 
are then slowly lowered on the screen. The timing loops keep the scrolling smooth. Every time 
the line is in the correct position, ANTIC is shut off, and the line is moved down one with a course 
scroll, but it is immediately scrolled up after ANTIC is turned on. A scroll down is not always as 
smooth as a scroll up. 

PLAYFIELD WIDTHS 

The width of the playfield is the number of columns that you can place information in. Up until 
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now, no matter which mode we worked in, the width of the screen was always the same - 40 
columns or 320 pixels. The width of the playfield does not have to remain constant. There are 
three different playfield widths that you can choose from. Try this in the direct mode: 

POKE 559,33 

Look at the screen! It is much smaller now. It is only 32 columns, or 256 pixels wide. 
Everything that is on the screen looks like it is in the wrong place. ANTIC doesn’t look to see how 
wide the screen is. It will still try to put 40 characters in a line. If the line is too short, it will put the 
rest in the next line. 

Now try this - POKE 559,35 

There is no margin on the left and right sides of the screen. Again, the information on the 
screen is not in the right place. This is the wide playfield. It is 48 characters or 384 pixels wide. 
The screen information will not be in the right place, because the information appears on the 
screen sequentially. If the line is longer than 40 characters, the information from the next line is 
placed on this line. To get back to the normal width, poke 559,34 or press the system reset key. 

These playfields can be used to create special effects. The wide playfield is used with the fine 
horizontal scroll. 


FINE HORIZONTAL SCROLL 

_ * 

The fine horizontal scroll is very similar to the fine vertical scroll. Every character in the line 
that is to be scrolled is moved to the right approximately 2 pixels. Clear the screen and try this in 
the direct mode: 

X = PEEK(560) + PEEK(561) * 256 + 7:POKE X,18 
This sets one line of the display list for the horizontal scroll. When you press the return key, 
the ‘X=’ will move to the left and seem to disappear off the screen. READY will appear under the 
8 and the left margin will seem to be on the right side of the screen. Now enter this: 

FOR Y=0 TO 15:POKE 54276,Y:NEXT Y 

The third line moves to the right and the entire line can be read. If you reverse the command: 

FOR Y=15 TO 0 STEP -1 POKE 54276,Y:NEXT Y 

the line will move back to the left. The rest of the screen is offset because this line is 8 characters 
or bytes longer than the other lines on the screen. READY is on the next line because the first 8 
bytes of the fifth line are now on the fourth line. Every line after that is offset by 8 bytes. If enough 
lines are set for the horizontal scroll, the offset will work itself back to the left margin. 

The next two programs are variations on a ticker tape routine. The first program performs 
the horizontal scroll using the same technique as was used with the vertical scroll. Notice that in 
addition to scrolling to the left, the message is also scrolling up the screen! Press the system 
reset key before the message goes too far. The second program shows a solution to this program. 

Listing 8-5. Fine Horizontal Scroll 
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Listing 8-5. Fine Horizontal Scroll (continued from page 129) 


6 0 D LIS T=P E E K ( 5 6 0 ) + P E E K ( 5 61 ) * 2 5 6 J S C R L 0 


U=PEEK(DLIST + 4)J SC 
M DISPLAY LIST ANI 
70 POKE DLIST +10 v I 


;rhi=peek(dlist+5):re 

i SCREEN MEMORY 
I::. I::. K ( 1J L .1. •::> I T 1 0 ) *f 1 6 <• R E M 
SET IT UP POR HORIZONTAL SCROLL 
80 A$ = “ STAY TUNE FOR AN IMPORTANT MESS 
AGE ON COMPUTERS " 

9 0 P 0 K E 5 4 2 7 6 * 15 1 R E M S E T S C R 0 L L T 0 T H E 
RIG H T 

10 0 P 0 SIT10 N 0 9 5 i ? A $ 

110 FOR X :::: 15 TO 0 STEP •••• 1 i P 0 K E 54276 
i FOR Y = 1 TO 40JNEXT YJNEXT X t REM SCROL 
L TO THE LEFT 

1 2 0 S C R L 01/1 ~ S C R L. 0 U + 4 i IF S C R L 0 U > 2 5 5 T H E N 
S C R HI* S C R HI +1 1 S c R L 0 W « S C R L 0 W • 255 
1 3 0 P 0 K E D LI $3 T + 4 v S C R L 0 W J P 0 K E D L. IS T i 5 >■ S 
CRH I 

140 FOR Y~I TO 10: NEXT YtGQTG 110 


Line 40 sets aside 48 bytes for the message. This is the number of characters that will fit on 
one line when the screen is set for the wide playfield. 

Line 50 clears the screen, sets the left margin to 0, and removes the cursor from the screen. 
If we did not set the left margin to 0, the computer would leave two bytes blank on the screen in 
the line that the message is printed in. These two bytes are where the left margin is for a normal 
playfield width. 

Line 60 finds the beginning of the display list and places the screen memory address in 
variables SCRLOW and SCRHI. 

Line 70 sets the sixth row of the screen for the fine horizontal scroll. The fine horizontal 
scroll is set by adding 16 to the value in the display list. 

Line 80 places the message into A$. Be sure to add the space after the last word, computers. 

Line 90 pokes 15 into memory location 54276. This will scroll the line all the way to the right. 

Line 100 prints the message on the sixth line of the screen. (The first line is 0.) 

Line 110 begins the horizontal scroll. The for...next loop decreases from 15 to 0, moving the 
message from the right to the left. 

Line 120 adds 4 to the low byte of the screen memory area. Scrolling from 15 to 0 moves 4 
characters off the screen. 

Line 130 pokes the new values into the display list and completes the scroll. 


Notice that the message spirals on the screen. Four characters at a time appear on the line 
above the scrolling line. This line is not set to scroll, so the characters stay there until the next 
course scroll. We are moving the screen display area, so even though we are moving the 
characters across on the line, we are also moving them up in the screen memory. 

The next program tries to correct this situation. When the words are scrolled to the left, the 
letters are removed and placed at the end of the line. The screen is still spiralling up the display, 
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but because the letters are constantly being removed from the beginning of the line and added to 
the end, it gives the illusion of remaining on the same line. 

Listing 8-5A. Fine Horizontal Scroll—Second Method 
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PLAYER/MISSILE GRAPHICS 

Many applications for using horizontal and vertical scrolling come to mind when you consider 
adding player/missile graphics. A map of the United States or the world could be drawn on the 
screen. To keep it at a reasonable size, you would not have to fit the entire map on the screen. A 
player could be used as a cursor. Moving the joystick would move the cursor up, down, left, or 
right on the map. When the red button on the joystick is pressed, the screen would scroll in the 
direction indicated by the joystick, exposing other parts of the map. 
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Chapter 9 


Page Flipping 


In the display list there are two bytes set aside to tell ANTIC where the beginning of the screen 
memory is. If we were to change these bytes, we would get some strange displays on the screen. 
It could be garbage, or it could be a clear screen. It all depends on what is in the memory area that 
ANTIC is trying to display. Try this in the direct mode: 

DUST=PEEK(560)+PEEK(561)*256POKE DLIST+5,6 

What do you see on your screen? This is the area of memory that we usually store machine 
language subroutines in because the operating system doesn’t use it. 

DISPLAYING TWO SCREENS 

By adjusting the memory that will be used by the screen, we can set aside memory for more 
than one screen display. We can then flip back and forth between the two screens. The new 
picture or message will immediately appear on the screen. If speed is critical, or you do not want 
the user to see the image being drawn, screen flipping is the answer. It does, however, use up a lot 
of memory. In the text mode, figure another IK of memory for each additional screen that you 
want displayed. If you are using a high resolution graphics mode, the memory cost is even more! 
The following program shows two messages that are displayed on two different screens. 

Listing 9-1. Screen Flipping 
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Listing 9-1. Screen Flipping (continued from page 133) 


8 T 

8 0 D L I... 2 - P E E K ( 5 6 0 > { D I... H 2 == P E E K < 5 61.) 1 D L 2=D 
L. I... 2 + D L.. H 2 * 2 5 6 1 S C1 ~ P E E K ( D L 2+4 ) l S C 2 - P E E K ( 

D L 2+5 ) l 8 C= S C :l. T S C 2 * 2 5 6 

90 POKE 752.1*? "THIS MESSAGE IS ON 

P A G E 2 “ i ? " W HIL E Y 0 U A R E R E A DIN G IT " { ? 

“I'M WRITING ON SCREEN 2" 

I 0 0 P 0 K E 8 8 V S C R1 { P 0 K E 8 9 r S C R 2 1R E M I... E T 
THE COMPUTER WRITE ON THE OTHER SCREEN 
110 ? " GOOD WORD! "JREM 2 ESC--DO 

UN ARROWS - FIVE SPACES 
12 0 P 0 K E 8 8 y S C1 { P 0 K E 8 9 y S C 2 { C ~ 0 { ? “ 

I'm ready press any key!"{REM 2 DOWN 
ARROWS -• 3 SPACE 
130 IF PEEK(764)=255 THEN 130 
140 POKE 764 y 255♦REM CLEAR THE HEGISTE 
R 

15 0 P 0 K E n L 2+4 . S C R1 { P 0 K E DI... 2+5 y S C R 2 1 R E 
M SHOW SCREEN 1 

160 FOR Y~1 TO 200{NEXT Y{REM TIMING L 
OOP 

16 5 ? " > C L E A R > “ {IF C T H E N 1.8 0 

170 ? "This was printed while you 
were watchind the other screen* 11 

{ C «1 { R E M 4 D 0 W N A R R 0 W S 

18 0 ? " p r e s s a n y k e y 11 t R E M D 0 W N A R R 0 W 


% TAB 


19 0 P 0 K E D L 2+4 r S C1 1 P 0 K E D L 2+5 y S C 2 { R E M 
RESET THE SCREEN 




00 GOTO 1 


3 o 


Line 40 sets the graphics mode to 0. This line also removes the cursor and clears the screen. 
This will be considered page 1. It is ready for something to be written on it. 

Line 50 finds the beginning of the display list. The location of the screen memory is stored in 
the fifth and sixth bytes of the display list. These values are stored in the variables SCI and SC2. 
The first byte of the screen is stored in the variable SCR. 

Line 60 subtracts 4 from the value in memory location 106. This memory location tells the 
computer how much memory (RAM) is available for it to use. It will count backwards from this 
location when setting aside screen space and the display list. By poking 4 less than the total 
number of pages of memory available, we are saving IK of memory of the screen and display list 
that we just initialized. 

Line 70 resets the display list and screen. Because we changed the amount of memory that 
the computer thinks it has, the first display list and screen display memory is intact. The screen 
memory and display list that the computer set in this line are lower in memory than those 
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established for the preceding screen. We now have two display lists and screen memories in the 
computer’s RAM. 

Line 80 calculates the new display list and the location of the new screen memory. This is the 
second display list and screen in RAM. 

Line 90 removes the cursor and prints a message on the screen. This message appears on the 
screen that you are looking at. 

Line 100 pokes the memory location of the first screen into memory locations 88 and 89. This 
is where the computer looks to see where the screen display area is. If we change these bytes to 
the location on the first screen, the computer will print or draw in that memory area. This will not 
affect the display that we are looking at. 

Line 110 is the message that the computer will print on the screen. This message will not 
appear on the screen that we are looking at because locations 88 and 89 have been changed. 

Line 120 sets the variable C to 0. C is used as a flag in this program. When it is 0, a second 
message will be printed on the second screen. When it is 1, the message will not be printed. The 
message between the quotes will be printed after C is set to 0. Before printing any message, 
memory locations 88 and 89 must be changed. If they were not changed back to the screen 
memory of the screen that we are looking at, we would not see this message. 

Line 130 checks memory location 764. When its value is not 255, a key has been pressed. The 
program will loop here until a key is pressed. 

Line 140 clears memory location 764 by resetting it to 255. If this location was not reset 
when the program looped back to line 130, it would think that a key had been pressed whether one 
was or not. 

Line 150 pokes the values for the first screen memory into the display list. Now the message 
that was poked into that memory area will be displayed on the screen. 

Line 160 is a timing loop to give you a chance to read the message. 

Line 165 clears this screen. This will not clear the screen that you are looking at! This will 
clear screen 2. If C is set, the program will go on to line 180. 

Line 170 prints a message on the screen and sets C to 1. This message is not printed on the 
screen that you are looking at, but at the other screen. 

Line 180 prints the rest of the message. 

Line 190 resets the screen by poking the screen memory area for the second screen into the 
display list. 

Line 200 sends the computer back to line 130 to repeat the program. 

To end the program press the system reset key. This will reset the display list and all the 
registers. If you press the break key, you will only stop the program but not reset any of the 
registers. 


This method of screen flipping can be used with other modes as well. In the next program, 
the screen will flip between mode 0 and mode 1. 


Listing 9-2. Simple Page Flipping: Two Different Modes 


.1.0 REM LISTING 9,2 


20 REM SIMPLE PAGE EL IPPING 
ERENT MODES 

30 REM B Y L <■ M * SC 1-IRE I BEE FOE 
40 GRAPHICS .1.7 


TWO DIFF 


TAB BOOKS 
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Listing 9-2. Simple Page Flipping: Two Different Modes (continued from page 135) 


5 0 D I... L .1.=P E E K ( 5 6 0 ) 1 D I... H1 = P E E K ( 5 61) 1 D I... 1 = D 
L L1+D I... H1 * 256 1 S C R1= P E E K ( D L1 + 4)1 B C R 2=P E E 
K(DL1+5) *SC R*S C R1 +SCR 2*256 

6 0 P 0 K E 10 6 r P E E K (10 6 ) •••• 4 1 R E M M 0 V E S C R E E 
N UP IK 

70 GRAPHICS 01 REM RESET THE DISPLAY LI 
ST 

8 0 D L L. 2 ~ P E E K ( 5 6 0 > J D L H 2 = P E E K ( 5 61 ) 1 D L 2 = D 
L L 2 + D I... H 2 % 2 5 6 1S C1=P E E K (D L 2+4) 1 S C 2 * P E E K < 
D L 2+5) 1S C= S C1+S C 2 * 2 5 6 
90 POKE 752i-11? “THIS MESSAGE IS ON 
P A G E 2 " 1 2 “ LI HIL E Y 0 U A R E R E A DIN G IT " 1 ? 

" I '' M W RITIN G 0 N S C R E E N 1 " 

10 0 P 0 K E 8 8 1 - S C R11 P 0 K E 8 9 v S C R 2 1 P 0 K E 8 7 r 
1 

110 ? #65"GOOD WORK" 

12 0 P 0 K E 8 8 i- S C1 1 P 0 K E 8 9 f S C 2 1 P 0 K E 8 7 r 0 1 
0=01? " I'm ready press any key! " 

130 IF PEEK(764)=255 THEN 130 

140 POKE 764 .» 255 1 REM CLEAR THE REG I ST E 

R 

.1.5 0 P 0 K E 5 6 0 f D I... I... 1 1 P 0 K E 5 61 ? D L H1 1 R E M S H 
OW SCREEN 2 
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<• | .... I 

<- \.f — . 1 . 

I o 0 l> " p v P •">«; n y U. p " 

190 POKE 560 y DLL2 t POKE 56 J. y DLH2 ♦ REM RE 
SET THE SCREEN 
200 GOTO 130 


Line 40 sets the display list for mode 1 without the text window. The rest of the listing is 
identical to the previous one with one exception. 

Line 150 changes the display list that the computer is using for the second screen to the 
display list for the first screen. 

Line 190 resets the display list for the second screen. 

By changing memory locations 560 and 561 for the different display lists, you can flip 
between screens that are in different modes. 

What if you want to display two screens simultaneously? It can be done. But with all the 
capabilities of the ATARI with one screen display, is there really a need to display two screens at 
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once? The next four programs illustrate different approaches that can be taken to display two 
screens at the same time. In all cases, there will be some flickering. 

Listing 9-3. Simultaneous Page Flipping—in BASIC 


.1.0 REM LISTING 9,3 

20 REM SIMULTANEOUS PAGE FLIPPING 

30 REM BY L.M.SGHREIBER FOR TAB BOOKS 
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Listing 9-4. Simultaneous Page Flipping—Two Modes 
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Listing 9-4. Simultaneous Page Flipping—Two Modes (continued from page 137) 


130 
140 
16 0 
3 0 


IF PEEK(764)=255 
:: 'OKE 560 t DLL1 i POKE 
0KE 560 y DLL.2 i POKE 


N 130 
5 61 y D L H1 
561 y D LI-12 1 GOTO 


Listing 9-5. Simultaneous Page Flipping: Machine Language Subroutine 
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Listing 9-5A. Simultaneous Page Flipping: Machine Language Subroutine—Horizontal Blank 


10 REM LISTING 9,5A 
20 REM SIMULTANEOUS PAGE ELIPPIf 


n h 
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C l-l IN E L A N G U A G E S U B E 0 l.J TIN E 

30 REM BY L* M«SCHREISER FOR TAB BOOKS 

4 0 G E A P l-l :i: c 8 0 : P 0 K E 7 5 2 t 1 : ? " > 11 

5 0 D!... I... .1 = P E E K ( 5 60 > l D L H 1 * P E E K < 5 6 1) t D I... 1 -- D 
L L 1 i D L H :l. Y 2 5 6 i S C R1 = P E E K ( D L1+4 ) J S C E 2 :::: P E E 
K < D L 1 + 5 ) J S C E ~ S C E1 + S C E 2 Y 2 5 6 

6 0 P 0 K E 10 6 y P E E K ( 1 0 6 ) — 4 i E E M M 0 V E S C E EL 
N UP IK 

70 GEAPI-1 ICS OiREM SET THE DISPLAY LIST 
TO ANOTHER MODE 

8 0 D LI... 2= P E E K < 5 6 0 ) J DI... l-l 2 =P E E K < 5 61 ) l DI... 2D 
L L 2+0 L l-l 2 * 2 5 6 l S C1 = P E E K ( DI... 2+4 ) i S C 2 » P E E K < 
DI... 2+5 ) $ S C ~ S C1 + S C 2 * 2 5 6 

9 0 P 0 K E 7 5 2 r 1 I P 0 SIT10 N 2 * 5 5 ? " T HIS C A N 


CEE ATE" 

1.0 0 P 0 K E 8 8 v S G EI i P 0 K E 8 9 r S C E 2 
I. :l. 0 ? " IN T E E E S TIN G E F F E 0 T S " 

120 POKE 206 y 8C2 1 EEH ADDRESS OF ONE SC 
v'EEN 

1.30 FOE X--0 TO 19: READ C ? POKE 1536 + X»C 
; NEXT X 

1.4 0 P 0 K E 15 5 3 r D L l-l 2 J P 0 K E 15 5 2 r D I... I... 2+5 ? P 0 
K E 2 0 9 r 4 t E E M W H E E E S C R E E N A D D E E S S IS S 


JELiJ 




O 
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4286 v 1 

0 0 "f 0 
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These four listings are nearly identical. 

Line 40 sets the mode to 0 (except in listing 9-4 where it is set to 17, which is mode 1 
without a text window), removes the cursor, and clears the screen. The display list is now set for 
the first screen. 

Line 50 finds the beginning of the display list, and the location of the screen memory for this 
mode. These values will be used later in the program. 

Line 60 moves the end of RAM IK. This protects the display list when we reset the graphics 
mode. 

Line 70 sets a new display list by setting the graphics mode. This new display list will be 
located before the old one. The screen display area for this mode will also be located before the 
other screen. The other display list is protected because 106 was poked with a number that was 
IK less than the actual amount of memory in the system. 

Line 80 finds the new display list and the screen memory locations for the second screen. 
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Table 9-1. Machine Language Subroutine to Flip Screen. 


d 0 c :i. iti a 1 c a d 0 
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L. D A 2 0 3 i I... o a d t h 0 a c c u m u I a t 0 r w :i. t h t h 0 
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y| ...03 d th© 

sccumulato 

r with th© 
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1 0 0 a t i 0 n 2 0! 

<■ 


Line 90 prints a message on the screen that we are looking at. 

Line 100 sets locations 88 and 89 for the first screen memory. In listing 9-4, location 87 is set 
for mode 1. This will place the message in the correct position on the screen. 

Line 110 prints the message on the screen. This message will appear on the first screen, not 
the screen that we are looking at. 

Line 120 is a loop in listing 9-3. The screen memory location in the display list is constantly 
changed between the first and second screen. Although both messages appear on the screen, 
there is noticeable flickering. 

In listing 9-4, line 130 waits for a key to be pressed. Each time one is pressed, the address of 
the display list is changed back and forth between the first display list and the second. This 
program flips the screens by changing the entire display lists because they are in two different 
modes. 

Listing 9-5 uses a machine language subroutine to flip the screens. See Table 9-1 for the 
assembly language listing of this subroutine. Once the machine language subroutine is poked into 
memory, the computer uses a USR command to access it. The screen will continue to flip until a 
key is pressed. There is less flickering with this method than the previous one, but it is still 
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noticeable. Lines 120 and 130 poke the addresses of both screens and the address of the display 
list where the screen memory should be placed—in memory locations that are not used by BASIC 
or the operating system. 

Listing 9-5A uses a display list interrupt to change the screens. Table 9-2 shows the 
assembly language listing for this routine. By using a display list interrupt, the screen is flipped 
every time ANTIC comes to that line in the display list. This method causes the least amount of 
flickering. 

Listing 9-5B. Simultaneous Page Flipping: Machine Language Subroutine—Vertical Blank 
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Listing 9-5B. Simultaneous Page Flipping: Machine Language Subroutine—Vertical Blank (con¬ 
tinued from page 141) 


K ( D I... 1 + 5) l 8 C R = S C R1 + S C R 2 * 2 5 6 
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t NEXT X 

1 4 0 P 0 K E 15 5 3 r D L H 2 l P 0 K E 15 5 2 y D L I... 2 + 5 t P 0 
KE 209y 4 1 REM WHERE SCREEN ADDRESS IS S 
TOPED 

1 5 0 D A T A 7 2 y 16 9 y 4 t 6 9 y 2 0 9 y 13 3 y 2 0 9 » 16 5 y 2 
0 6 y 2 4 y 101 y 2 0 9 y 141 y 10 y 2 .1. 2 r J. 41 y 0 y 0 1 10 4 y 7 


• ••• •••• ••• 

.. O I-. • .' * ) ' 

O M 7 V A-.. »..) 


160 FOR X—1560 TO 157 It READ Cl POKE X y C 
t NEXT X 

17 0 D A T A 10 4 y 10 4 v 10 4 y 16 8 y 10 4 y 10 4 y .1.7 0 y 1 
04y104y76y92y228 

18 0 Q :::: l J S R ( 15 6 0 y 0 y 6 y 6 ) 

190 GOTO 190 


* 


Listing 9-5B uses a slightly different method of screen flipping. The machine language 
subroutine is accessed on the vertical blank. Every 60th of a second, the raster scan reaches the 
bottom right corner of the screen. When it shuts itself off to go back to the top-left corner, there is 
a vertical blank. By flipping the screen at this time, each screen is displayed for l/60th of a second 
30 times in one second. Theoretically, you should not see any flickering here because the eye 
detects movement at l/20th of a second. This is the most reliable way to display two screens at 
the same time. 

The machine language subroutine used here is executed during the vertical blank. The 
computer has certain routines that it must perform during this period. There is time, though, to 
insert your own code for the computer to execute in addition to its own. The trick is to steal the 
vector or address location for your own use. In this program we are using the immediate vertical 
blank vector for our routine. Any time that a machine language subroutine is executed during an 
immediate vertical blank, it should end with a jump to 58463. A machine language subroutine can 
also be used during the deferred vertical blank. This routine should end with a jump to 58466. 
These addresses contain the routines that the computer needs to perform during the vertical 
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Table 9-2. Machine Language Subroutine—Horizontal Blank. 
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blank. As the name implies, an immediate vertical blank routine is performed as soon as the 
blanking period begins. A deferred vertical blank is executed after other routines are completed. 

The routines that you want executed should be fast and to the point. There is a time limit for 
these routines. If they are too long they could cause problems with the display by changing 
registers while the scan is turned on. Routines performed during the immediate vertical blank 
should not exceed 300 machine cycles. Routines using the deferred vertical blank can be about 
25,000 machine cycles. Remember, a machine language instruction is not a machine cycle long. 
Some instruction can use up to 7 machine cycles. 

The USR routine passes the address of the machine language subroutine that the vertical 
blank will use to another machine language subroutine. ATARI has a routine in its operating 
system to set up immediate and deferred vertical blank routines. To set the address for the 
routine, you must call a routine at location 58460. When this routine is called, the address of your 
machine language subroutine must be stored in the Y (low order address) and X (high order 
address). A 6 must be in the accumulator if it’s an immediate vertical blank routine; a 7 if it’s a 
deferred. The machine language subroutine at location 1560 accomplishes this. See Fig. 9-3 for 
the assembly language listings for these routines. 

CREATING SLIDES 

With some screen flipping and a disk drive, an entire presentation can be displayed. Slides, 
pictures, or graphs can be prepared ahead of time and stored on disk. Then, under program 
control, the slide could be loaded into the computer’s memory. While one picture is on the screen, 
another could be loaded into another part of memory. By pressing a key, the computer would ‘flip’ 
to the other picture and load a new picture into the screen memory that is not being shown any 
longer. The following program will allow you to create slides that will be stored on disk. The 
program after it will retrieve those slides in any order than you want. 


Table 9-3. Machine Language Subroutine for Vertical Blank. 


76 

JMP 58463 ;Jump to this address to 

95 

computer's routines. 

228 



replace the return from interrupt with this jump to complete the vertical interrupt routines. 

decimal code 

assembly language instructions 

104 

PLA 

Get value from stack (?) 

104 

PLA 

Get value from stack (0) 

104 

PLA 

Get value from stack (0) 

168 

TAY 

Transfer it to index Y. 

104 

PLA 

Get value from stack. (0) 

104 

PLA 

Get value from stack. (6) 

170 

TAX 

Transfer it to index X. 

104 

PLA 

Get value from stack (0) 

104 

PLA 

Get value from stack (6) 

76 

JMP 58460 

Jump to address to set up 


subroutine to run during 

92 

vertical blank. 

228 




— change for machine language subroutine Boot routine to set up subroutine during vertical blank. 
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Listing 9-6. Slide Editor 


10 REM LISTING 9*6 
20 REM SLIDE EDITOR 

30 REM BY I... * M <• SCREE I BEE FOR TAB BOOKS 
32 FOR X--1536 TO 1548 X READ B SPOKE X ? B J 
NEXT X * UP~153 6X REM ROUTINE TO MOME UP 
3 4 D A i A 10 4 y 1 6 0 y 0 y 2 0 0 y 1 /' 7 v 2 0 5 y 13 6 y 14 5 y 
205 y 200 y 208y 247y 96 

3 6 F 0 R X==15 5 2 T 0 15 6 4 X E E A D B 1 1-' 0 K I::. X y B l 
NEXT X » DOWN--1552 ? REM ROUTINE TO MOVE D 


3 8 D A T A 10 4 t 1.6 0 y 2 5 5 .»1.3 6 y 17 7 y 2 0 5 y 2 0 0 y 14 
5 y 2 0 5 y 13 6 y 2 0 8 y 2 4 7 y 9 6 

4 0 DIM N A M E $ (14 ) y N T ( 8 ) 

5 0 N A M E $ < 1 ) « " " X N A ME $ < 12 > a" " ? N A M E $ < 2 > 

N A M E 1|: X N A M E $ a " D X “ X R E M C I... E A R T H E S T RIN G 

60 ? ">CLEAR>PLEASE ENTER THE NAME 0 
F T l-l E PIC 1" U R E 11 ? IN PIJ T N $ ? N A M E * < 3 ) a X N A 
M E $ ( 11 y 14 > a 11 y D R W 11 X IF N T == “ " I' H E N 5 0 
70 GRAPHICS 215 REM SET DISPLAY FOR GRA 
PHICS MODE 5 - NO TEXT WINDOW 
8 0 P M a p E E K < 10 6 ) - 8 X P 0 K E 5 4 2 7 9 y P M ? P 0 K E 2 
0 5 y 0 X P 0 K E 2 0 6 y P M i 2 X P M=P M * 256 X R E M B E GIN 
NING OF PLAYER 

8 5 D I... IS T == P E E K ( 5 6 0 ) + P E E K < 5 61 > * 2 5 6 
90 POKE 559y46?REM 2-LINE RESOLUTION F 
OR PLAYER 

10 0 P 0 K E 53 2 7 7 y 3 i R E M E N A B I... E P L A Y E R / MIS 
SILE GRAPHICS 

110 FOR X--PMT512 TO PM+6 40 X POKE XyOJNE 
XT X X REM CLEAR MEMORY FOR PLAYER 
12 0 R E S T 0 R E 13 0 X F 0 R X « P M+5 2 5 T 0 P M+5 3 2 
J READ B X POKE X y B J NEXT X X REM MAKE CURSO 


13 0 D A T A 2 4 y 2 4 y 2 4 r 2 31 t 2 31 y 2 4 y 2 4 y 2 4 

14 0 P 0 K E 7 0 4 y 12 X R E M C 0 L. 0 R P L A Y E R W HI "f E 

15 0 1-1 Z a 4 7 X V T a 0 : X «1 X Y a 0 ? C « 2 
ISO POKE 53248yHZ 

170 IF PEEK<764)=255 THEN 220 
18 0 B a p E E K ( 7 6 4 ) •••• 3 0 X IF B = 1 T H E N C=B X G 0 T 


0 220 


200 II 
210 II 


BaO THEN 02 J GOTO 220 
Ba-4 THEN 0=3 J GOTO 220 
B -- — f |-| |- N C == 4 


220 P 0 K E 7 6 4 y 2 5 5 X IF P E E K < 5 3 2 7 9 ) == 6 T H E N 
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Listing 9-6. Slide Editor (continued from page 145) 


350 


230 

v 

IF 

b 

T RIG 

(0) 

-0 THEN 

COL 

OR c:pl 

. 0 T 

X y 

i 

240 

IF 

b 

TICK 

(0) 

=15 THE 

N 17 

0 



250 

IF 

b 

TICK(O) 

=7 AND 

V ..** *7 O 
/\ ••. j 7 

THEN > 

r .... v 
i •••• A 

+1 ? 

HZ- 

HZ + 

n ♦ 

POKE 

5 J 

248 r HZ 1 

GOTO 

170 



260 

IF 

n 

b 

TICK 

<0 > 

1 AND 

X > 1 

THEN X 

t M#t \ / 

.A 

-1 1 

HZ* 

HZ- 

n * 

POKE 

S3 

248 r HZ.: 

GOTO 

170 



270 

IF 

b 

TICK 

(0) 

=13 AND 

Y < 4 

7 THEN 

Y .... 

Y +1 


1 1 Q 


••I 


IQ 


: q = u s r (n o u n ): o=u s r < d o u n ): g o t o i 7 0 

280 IF STICK < 0) = 14 AND Y>0 THEN Y=Y-1 
Q-USR (IJP) J Q-USR (UP) l GOT0 170 
290 IF STICK < 0) =6 AND X<79 AND Y>0 TH 
N X = X + 1 t H Z = H Z + 2 1 P 0 K E 53 24 8 r H Z $ Y=Y -1 1 Q 
U S R (U P) 1Q = U S R (U P) i 0 0 T 0 17 0 
300 IF STICK(0)“5 AND X<79 AND Y<47 
E N X-X +1 : H Z = H Z + 2 : P 0 K E 53 2 4 8 r H Z J Y = Y + 

= IJsR < D0UN ) 1 Q=IJSR ( D0UN ) t 00T0 170 
310 IF STICK (0) :: =9 AND X>1 AND Y<47 
N X = X - 1 1 H Z = H Z ~ 2 1 P 0 K E 5 3 2 4 8 r H Z t Y = Y1-1 

USR(D0WN >:Q=USR<D 0UN)iG 0T 0 17 0 
320 IF STICK <0)==: 10 AND X>1 AND Y>0 THE 
N X-X- 1 J HZ-HZ-2 % P0KE 53248 t HZ t Y- Y-■ 1 i Q~ 
USR(UP )t Q-tJSR(UP) 

330 GOTO 170 

340 REM SAVE SCREEN TO DISK 
3 5 0 S C R BP E E K (D LIS T f 4 ) + P E E K < D LIS T i 5 
56 l SCRE- SCRB+9 59 
3 6 0 0 P E N # 2 v 8 r 0 r N A M E * 

370 FOR X-SCRB TO SCREJPUT #2vPEEK( 
NEXT XJCLOSE #2 
380 POKE 53248 y 0 ? GOTO 50 


)#2 


*• / \ A 

A ) * 


Line 32 places into memory the machine language subroutine that moves the cursor up. This 
subroutine will be located on the 6th page of memory. This page is left blank by ATARI for 
program routines or other uses that you may have for particular memory locations. The contents 
of this memory will not be changed by pressing the system reset key. The variable UP is set to the 
first address of this routine. 

Line 36 moves the machine language subroutine from line 38 into the memory locations that 
follow the up routine. This machine language subroutine will move the cursor down. The variable 
DOWN is set to the address of this routine. It is important that the numbers in these data lines are 
copied exactly as listed here. The wrong number could cause the program to crash. 

Line 40 sets aside string space for the name of the picture that will be drawn on the screen. 
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Line 50 clears the string and sets the first two bytes of the string to D:. This will be the string 
that will place the name of the screen into the disk directory. 

Line 60 clears the screen and asks you to enter the name of the picture. This name is stored 
in N$. It is then transferred to NAME$ beginning with the 3rd position. The string will end with 
the extender .DRW. If you tag an extender to all files created by a particular program, you can 
retrieve them just by looking at the extenders. This line also checks to see that a name was 
actually entered. If one hasn’t been, it will repeat itself until one has. 

Line 70 sets the graphics mode to 5 with no text window. We could actually use any mode for 
this program. However, since 5 is neither the highest nor lowest resolution, we will use it in this 
program. 

Line 80 sets the beginning of the player/missile graphics area 2K below the end of memory. 
This value is poked into 54279. Now the computer knows where the player/missile area begins. 
Memory location 205 is poked with a 0, and location 206 with the beginning of the player/missile 
area plus 2. We will be using the first player for this program. We will also be using the 2-line 
resolution for the player. This means that the first player will begin 512 bytes after the beginning 
of the player/missile area. 512 is 2 pages of memory (512/256=2). This is the value placed in 206. 
The memory locations 205-206 are used by the machine language subroutine to move the player 
up and down. It needs to know where in memory the player begins. The value PM is then 
multiplied by 256 to get the actual decimal value for the beginning for the player/missile area. 

Line 85 stores the beginning address of the display list in the variable DLIST. 

Line 90 pokes memory location 559 with 46. This enables the player/missile graphics for 
2-line resolution. 

Line 100 pokes 53277 with 3. This enables the player/missile graphics. If this location is not 
poked, the players will not be displayed. 

Line 110 clears the memory for the first player. This is done because there could be data in 
those bytes from a previous program or garbage from power-up. This would be displayed on the 
screen along with our cursor. 

Line 120 tells the computer where the information to draw the cursor will begin. The data 
from the next line is read and stored in the first player area. 

Line 140 places the color in the color register for the first player. We will be using white. 
This number can be changed for any color. 

Line 150 sets the variables that will be used in moving the cursor and drawing the colors on 
the screen. The variable HZ is the horizontal position of the cursor. Position 47 places the cursor 
along the left side of the screen. It is equivalent to the graphics position for the first column. The 
variable X is the column for the plot command; the Y is the row. The variable C is used for the 
color. The program begins with the color set to 2. 

Line 160 pokes the value of HZ into location 53248. Now the cursor will appear on the screen. 

Line 170 checks location 764 to see if a key has been pressed. When a key has been pressed, 
the value of this location will not be 255. The computer will move directly to line 220 if no key has 
been pressed. 

Line 180 t&kes the value in location 764, subtracts 30 from it, and stores it in the variable B. 
The value at location 764 will not be the ATASCII value of the key pressed. It is a hardware value 
for that key. If B is 1 (the hardware value was 31), then the 1 key was pressed, and the variable C 
will be 1. The color in color register 1 will be drawn on the screen. 

Line 190 will set the value of C to 2 if key number 2 was pressed. The color in color register 2 
will now be used to draw on the screen. 
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Line 200 sets the value of C to 3 if key 3 was pressed. The color in color register 3 will be 
used. 

Line 210 sets the color value to 4. There is no color value 4 since mode 5 uses three colors 
plus the background color. This value will have no color value and can be used to erase the lines 
that were drawn. 

Line 220 resets the value in location 764 go 255. This clears the location for a new input. 
Whenever the keyboard is read this way, the program must reset that register. Then the 
computer checks to see if the start button has been pressed. If this button has been pressed, the 
computer will be directed to the part of the program that saves the screen onto disk. 

Line 230 checks to see if the red button on the joystick is pressed. This is the only way to 
draw on the screen. If the red button is not pressed, the cursor may be moved without drawing 
lines on the screen. 

Lines 240-320 check the position of the joystick. If it has not moved, the program repeats 
itself with line 170. If the joystick has been moved, the program checks to see if the cursor can 
move. The highest numbered column on the right side of the screen is 79. If the variable X is less 
than 79, then the cursor can move to the right. The lowest value that X can be is 1. The 0th column 
does not show up on all screens. Only when the value of X is greater than 1 can the cursor be 
moved to the left. The top of the screen is row 0. If the variable Y is greater than 0 then the cursor 
can move up. The bottom row on the screen is 47. The cursor can move down as long as Y is less 
than 47. Even though the variables X and Y have only 1 added to them whenever the cursor moves, 
the horizontal and vertical positions must be moved by 2. One row or column in mode 5 is two 
rows or columns for the player. Every time the horizontal variable (HZ) is changed, the new value 
must be poked into 53248. To move the cursor up or down, execute the machine language 
subroutine to move the cursor twice. To move the cursor on a diagonal, both the machine 
language subroutine and the horizontal register must be used. The lines to move the cursor 
diagonally (290-320) check two edges of the screen before moving the cursor. The routine ends by 
sending the computer back to line 170. It continues this loop until the start button or the system 
reset key has been pressed. 

Lines 350-380 save the screen to disk. The variable SCRB is set to the first byte of the 
screen. The ending byte is calculated by adding 959 to the first byte. (The screen only uses 960 
bytes of memory in mode 5.) Line 360 opens the buffer to write a file to the disk. The name of the 
file is contained in NAME$. The for....next loop in line 370 peeks at every screen memory 
location from the first byte to the last and stores the bytes on the disk. When the entire screen has 
been saved to disk, the buffer is closed. The player is moved off the screen and the program 
returns to line 50. If you want to draw another screen, you can enter its name. If you want to quit, 
you can press the system reset key. 

Listing 9-7. Slide Show 


10 REM LISTING 9,7 
20 REM SLIDE SHOW 

30 REM BY L*M*SCHREISER FOR TAB BOOKS 

4 0 S C R .1. = < P E E K < 1 0 6 ) - 4 ) * 2 5 6 J S 2~ S C R1 / 2 5 6 % 
S1=S C R1 - S 2*2 5 6 X R E M FIR S T S C R E E N M E M 0 R Y 

5 0 P 0 K E 10 6 9 P E E K ( 10 6 ) -• 4 X R E M S A 0 E T H A T 
AREA OF MEMORY 
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60 GRAPHICS 0 ? REM RESET NEW SCREEN AND 
DISPLAY LIST 

7 0 DIM N A i v i E $ ( 14 0 ) v N $ ( S ) i S C R $ ( 14 ) ? R I::. M R 
COM FOR 10 SCREENS 

7 5 N A i v i E $ ( 1 ) ~ » » ? N A M E $ < 14 0 ) ~ " " ? N A H E $ (2 

) = N A M E $ ? S C R $~N A M E $ ? N $ S C R * 

80 ? "HOW MANY SCREENS ”5?INPUT S 

?REM THREE SPACE AND BACKSPACES 

90 IF S>10 THEN 80?REM NO MORE THAN 10 

q n |:j p p i\j q 

10 0 F 0 R' X -1 T 0 S i ? " E N T E R “5X5 11 S C R E E N 
”5?INPUT N*:REM GET THE NAMES OF THE S 
GREENS 

110 S P - X >K 14 -• 13 ? N A M E $ < S P ) - " D l " ? N A M E $ < S P 
+2 y S P+9 > = N $ i N A M E $ ( S P +10 ) = “ , D R W " ? R E M E N 
TIRE NAME 
120 NEXT X 

130 GRAPHICS 21?REM SET 2ND SCREEN 
14 0 D L. IS T = P E E K (5 6 0) + P E E K < 5 6 1) *25 6 ? S C R 2 
=P E E K ( 8 8 ) + P E E K ( 8 9 ) >K 2 5 6 ? R E M S E C 0 N D S C R E 
EN AREA 

150 F~0 1 FOR X=1 TO S?REM NOW GET THE S 
GREENS 

1 6 0 S P “ X * 14 •••• 13 : S C R «=N A M E $ (8 P t S P+13 ) { R E 
M NAME OF SCREEN TO BE DISPLAYED 
170 SCREEN~SCR2?IF X/2=INT(X/2) THEN S 
C R E E N ~ S C R1 J R E M G E T T H E RIG H T S C R E E N 
180 OPEN *2r4»0»SCR$ 

19 0 F 0 R Z ^ S C R E E N T 0 S C R E E N+9 5 9 t G E T # 2 1 
S i P 0 K E Z v s : N E X T Z t CI... 0 8 E # 2 t R E M G E T S C R 
EEN FROM DISK AND PUT IN MEMORY 
200 IF X : “2 THEN F*1 

210 IF F THEN GOSUB 300?REM WAIT FOR S 
TART 

220 NEXT X 


230 GOTO 230 
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Line 40 subtracts 4 from the amount of RAM shown in location 106. This IK of memory will 
be set aside for one screen. The variable S2 is the high order byte of the screen memory, Si is the 
low order byte. 
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Line 50 changes the value in 106 by poking it with the value that was there less 4 (IK). Now 
the computer thinks that it has IK less of memory and will not touch the memory past this 
address. 

Line 60 resets the display list and screen. Since there is less memory for the computer to 
use, the display list and screen are relocated. 

Line 70 sets aside string space for the names of the screens that will be shown. NAME$ will 
contain the names of all the screens that will be shown. Each screen name needs 14 bytes or 
character spaces. There is room for 10 titles as the program stands. Increase the amount of string 
space by adding multiples of 14 to 140. 

Line 75 clears all the strings. There can be data in the strings that can interfere with the 
program. The easiest solution is to clear out strings that have been fielded. 

Line 80 asks for the number of screens that you are planning to display. After the word 
SCREENS come three spaces and three backarrows. This will clear out a previous entry if it was 
more than 10. The number of screens that you plan to show are stored in variable S. 

Line 90 checks S to see if it is greater than 10. If it is, line 80 will repeat. If you changed 
NAME$ for more than 10 titles, change the 10 in this line to reflect the number of screens that can 
be entered. 

Lines 100-120 allow you to enter the titles of the screens that you want displayed. Be sure to 
enter the names correctly. There is no trap in this program for wrong titles. The titles should be 
entered exactly as you entered them when you saved them in the previous program. The 
computer will add the D: to the beginning of the name and the .DRW to the end. 

Line 130 sets the screen for mode 5 with no text window. This is the mode that the pictures 
were drawn in, so this is the mode that they must be shown in. 

Line 140 finds the beginning of the display list and the beginning of the screen memory for 
this display list. In addition to the fifth and sixth locations in the display list, the beginning location 
of the screen memory area is also stored in decimal locations 88 and 89. 

Line 150 starts the loop that loads the screens into memory. The loop will be repeated the 
number of times that S is set for. 

Line 160 extracts the name of the first screen from NAME$. The variable SP will be the first 
byte for the name of the screen. The value of X will be multiplied by 14 (there are 14 bytes for each 
name) and 13 will be subtracted from that answer. That points SP to the first letter of the name of 
the screen. Since D: was added to every name, SP should be pointing to a D. The string SCR$ will 
hold the name of the screen. The next 13 bytes after and including the byte that SB is pointing to 
will be stored in SCR$. 

Line 170 stores the value of SCR2 in SCREEN. SCR2 is the first byte of the second screen. 
Then the variable X is checked to see if it is even or odd. If X is even, X/2 will be equal to the 
INT(X/2). The even screens are displayed on the first screen. The variable SCREEN will be 
changed to the first byte of the first screen. Now the screens will load, alternating between the 
first and second screen. 

Line 180 opens the buffer to read the file from the disk. If SCR$ contains the wrong 
information, the program will crash. 

Line 190 gets the bytes from the disk and stores them in memory from the first byte of the 
screen to the last. After the entire file is read to the screen, the buffer is closed. You will be able to 
watch the first picture being drawn on the screen. 

Line 200 checks the value of X. If it is greater than 1, then the computer will go to the 
subroutine that waits for the start button to be pressed. 
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Line 210 finishes the loop. If there are more screens to be loaded, the computer will loop 
back and load the next screen. This time, the picture will be loaded on the screen that is not being 
displayed. 

Line 220 loops until the system reset key is pressed. 

Lines 300-330 changes the screen that is being viewed. While one screen is displayed, the 
computer loads in another screen. When the start button is pressed, the computer compares the 
value of location 88 with the value of the screen in the display list. If these are not the same, the 
first screen is being displayed and the computer loads the values of locations 88 and 89 into the 
screen display in the display list. Now the second screen is displayed, and the routine returns to 
the main program. If the second screen is being displayed, the computer places the first screen 
address into the display list. 

This method of page flipping can be used for any number of screens. The only thing to 
remember is-DO NOT PRESS START UNTIL THE DRIVE HAS SHUT OFF. The program can 
also be designed to show a series of slides without any human intervention. Every slide ends with 
a .DRW. The program can load in the files by checking every entry on the disk for the .DRW. Use 
the * for the name of the program and .DRW for the extender. The computer will only choose 
those files that end in .DRW. A timing loop will leave the pictures on the screen long enough to be 
viewed without getting monotonous. 

With a little ingenuity, the program can load entire display lists as well as the pictures so that 
the slides can use multimode resolutions and alternate character sets. 
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Chapter 10 

Sound 

Generators 


All sounds are generated by the same mechanism—the movement of air. How fast, how long, and 
with how much force this vibration occurs will govern the sound that we hear. A kitten’s purr is 
quite distinguishable from a lion’s roar! 

By careful manipulation of the sound registers, a variety of sounds and effects can be created. 
The four sound or voice channels that the ATARI has can be used alone or in combination with 
each other. Each channel can be set for a different distortion. This can be used to create strange 
sound effects for programs. 

THE AUDIO CHANNEL CONTROL 

Every sound has the same characteristics—attack, decay, sustain, and release. The actual 
tone depends on the frequency or number of pulses generated in a given time period. The higher 
the frequency, the higher the note or tone. 

In the sound command four different options must be set: SOUND v,p,d,1. 
v=voice. There are four different voices or sound channels that can be used. Each is set by 
using the numbers 0-3. Each voice must be set with a separate sound statement. 

p=pitch. This is the frequency of the tone. Any number from 0-255 can be used. The higher 
the number, the lower the tone. A zero will produce no tone—just a clock from the speaker. The 
actual sound of the tone will depend on which distortion setting is used. 

d=distortion. The distortion here means the noise content of the sound that will be 
generated. The distortion value will tell the computer how to generate the pulses that will 
become sound. Only values of 10 or 14 will produce pure tones. 

l=loudness or volume. The tones can be loud or soft. Each voice channel can be set 
independently. The only restriction is that the sum of the volume of the voices used cannot exceed 
32. 


The following program demonstrates how the tone (p) can vary depending on the level of 
distortion (d). The number of the pitch as well as the distortion will be printed on the screen while 
you listen to the tone. 
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Listing 10-1. Sounds 


:L0 REM LISTING 10*1 
20 REM SOUNDS 

' 30 REM BY L ♦ M ♦SCHREISER FOR 
40 FOR P=5 TO 255 STEP 51? 


TAB BOOKS 
y 1 REM STEP 


THE NOTES BY a 


i::; 


' ! *? D y t REM CHANG 


50 FOR D-0 TO 14 STEP 
E THE DISTORTION •••• USE ONLY EVEN NIJMBE 
R S 

60 SOUND 0»P»D»10iF0R Y~1 TO 200 l NEXT 
Y1 REM LISTEN TO THE SOUND 
70 NEXT D t ? t REM GO THROUGH ALL THE SO 
UNDS ~ THE PRINT LETS THE NEXT PITCH S 
TART ON A NEW LINE 

SO NEXT P 


Line 40 begins the for ... next loop to change the pitch that the sound register will use. The 
number of the pitch will be printed on the screen. 

Line 50 begins the for ... next loop to change the distortion of the sound register. Only the 
even numbers from 0-14 can be used for the distortion. Each pitch or tone will be heard in all 8 
distortions. 

Line 60 plays the sound. The value of the pitch and/or distortion will be different each time 
this line is executed. The for . . . next loop here gives you time to listen to the sound created. 

f 

Lines 70-80 complete the loops. 


As you can hear, some of the distortions of a pitch are very similar to others in the same pitch. 
Others have no sound at all. The only pure tones are generated by distortions 10 and 14. 

The volume of the sound can be used to enhance the sound created. Too often the sound is a 
“set it and forget it” function. Listen again to the sounds generated by the last program. Each 
sound came on and went off. True sounds do not occur this way. Listen to a piano key being struck, 
then a drum, and finally a horn (wind instrument) being blown. Each instrument produces its own 
unique sounds. Although both an organ and a piano are keyboard instruments, they have their own 
sound qualities. The time that a tone takes to reach its amplitude (height of sound) is called attack 
time. The decay time is the time it takes for the sound to start to fade, the sustain time is the length 
of time that the tone is heard (still vibrating). At the release time , the tone has faded away 
completely. The piano is the best example of these four factors. When you strike the key, you 
immediately hear the tone. It is loud and clear. This is the attack time. That loudness does not 
continue for an extended period of time. Very quickly the tone starts to fade. This is the decay 
time. The tone does not die away completely. The length of time that you can still hear the tone is 
the sustain level. When the tone finally fades completely, it is the release time. 

The following program creates an interesting effect when attack, delay, sustain, and release 
time are inserted into the program. 
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Listing 10-2. Sounds with Attack and Decay 


10 

REM 

LISTING 

i 

1 o ♦ 

2 





2 0 

REM 

SOUNDS- 

•WITH 

A T T AC 

K X 

DECAY 

3 U 

REM 

BY L ♦ M * 

s 

CMREIBE 

R 

FOR 

TAB 

BOOK'S 

4 0 

FOR 

X=1 TO 
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4 ? R 
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GET 
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NE 

UAL 

IJE 
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py 10y V 

if 
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=1 TO 10 
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NEX 

r r: 

NE 

XT V 

J REM 

A T T AC 


K 

60 FOR V -- :l. 4 TO B STEP -2 J SOUND OyF'ylOy 
VJFOR Y=1 TO 20JNEXT Y i NEXT 0 l REM DECA 
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•••I A 

/ V 

FOR Y~1 ' 

8 0 

FOR V-6 ’ 

:ne 

XT VJFOR 

|.... .... 


9 0 

NEXT X;R1 

. 1 . u u 

DATA 12: 

Q A r 

> (.) 9 

9 6 « 1 0 B '1 (' 


A*.. * 


SOUND 0yp?10 


y 


I. 9 91 9 9.1. 9 


Line 40 reads the pitch values from the data line. These are the tones that the computer will 

play. 

Line 50 simulates an attack. The volume begins at 0 and gradually works its way up to 14. At 
each level, a timing loop holds the tone and volume level. 

Line 60 is the decay. The volume gradually decreases. The timing loop is longer here so that 
it will take a longer time for the sound to fade. 

Line 70 is the sustain. This is the length of time that you will hear the sound. The volume will 
remain the same. 

Line 80 reduces the volume of the sound to 0. This is the release time. The timing loop here 
gives each tone generated its own time. If there was not a clean break between the tones, the tone 
would appear to run into each other. 

Line 90 completes the loop. 


The sound created by this program gives the effect of an accordian. You can almost hear the 
bellow opening and closing with each attack and decay. The next program uses a slightly different 
technique to create attack and decay. There is a very definite vibrato to the melody. 

Listing 10-3. Sounds with Attack and Decay—Vibrations 


10 REM 
20 REM 
30 REM 
40 DIM 


LISTING 10,3 
VIBRAT IDNS 
BY L♦M♦SCHREIBER 
A $ < 12 > 


FOR TAB BOOKS 
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Listing 10-3. Sounds with Attack and Decay—Vibrations (continued from page 155) 
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Line 40 dimensions A$ for the volume settings. 

Line 50 sets the volume sequence in A$. 

Line 60 reads the pitch from the data line at the end of the program. 

Line 70 contains the timing loop and the sound statement. This time the entire range of 
volumes will be changed rapidly a number of times rather than changing the volume and holding it 
for a period of time. The volume sequence will be used three times. The variable V will contain 
the volume. As Z is increased from 1 to 12, the correct volume will be removed from A$. 
Line 80 holds the last volume of the sound for a few seconds, then turns it off. 

Line 90 completes the loop. 

DIRECT ACCESS 

Like most commands in ATARI BASIC, there are hardware registers for the sound 
generators that can be set by poke commands. For each voice that you want to set, there are two 


addresses that must be 

poked. 


Voice 

Frequency 

Audio 

# 

Register 

Control 

0 

53760 

53761 

1 

53762 

53763 

2 

53764 

53765 

3 

53766 

53767 


The frequency register can be poked with any value from 0-255. This has the same effect as 
the P variable in the sound command. 

The audio control register is a combination of the volume variable (V) and the distortion 
variable (D). To find the number that should be poked here, multiply the distortion value by 16 and 
add the volume. 

By knowing where these register are, it is possible to use only the register that you need in a 
program. This will make it execute the sound changes faster because the one register will be set 
directly, and BASIC will not have to reset registers that are already set; for example, if the 
volume and distortion are set, and you have no reason to change them, you can poke the frequency 
register with the pitch or tones. If you use the sound statement, BASIC will recompute the 
distortion and volume each time it executes the sound command. 

There is one more control register for the audio. This register can change the way that the 
tones are generated. In the previous examples, we used one sound generator. We could easily 
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change the program to use two, three, or all four generators. For an actual tune, this would 
generate some harmony. For sound effects, a second or third sound register will add to the 
realism of the sound. It is also possible to use two registers together to form a 2-byte tone 
generator. This will increase the range of sounds that the computer can generate. 

In the next program, address 53768 is poked with 16. This will couple sound register 0 with 
1. Register 0 is the low order byte and register 1 is the high order byte. As the tones begin, you 
will notice that as long as register 1 is set to 0, the tones sound the same as those generated with a 
single sound register. Once the value of register 1 changes, the tones become deeper, until they 
become so very deep that they do not seem to change their pitch. 


Listing 10-4. Variations on Tones 


10 REM LISTING 10,4 

20 REM VARIATIONS ON TONES 

30 REM BY L♦M♦SCHREIBER FOR TAB BOOKS 

4 0 P 0 K E 5 3 7 6 8 9 1 6 l R E M I... IN K V 0IC E S 0 8 1 

SO POKE S3761?170 

60 FOR P=0 TO 255:POKE 53762yp t? "SOON 
D REGISTER 1= b JPf 

70 FOR P1 --0 TO 255 STEP 5; POKE 53760 vP 
1 J ? P1 ? 

SO FOR Y :: = 1 TO 100 i NEXT Y i REM TIMER 
90 NEXT P1J? JNEXT P 


Line 40 pokes location 53768 with 16. This joins sound registers 0 and 1 into one register. 

Line 50 pokes location 53761 with 170. This is equivalent to a distortion of 10 and a volume of 

10 . 

Line 60 begins the for ... next loop that changes the pitch content of register 1. This register 
will increase in value once every time the register 0 reaches 255. 

Line 70 begins the for . . . next loop to change the pitch value in register 0. Every time this 
register cycles from 0 to 255, register 1 will be increased by 1. 

Line 80 is a timing loop to give you a chance to hear the tones being generated. 

Line 90 continues the loop until all the tones have been generated. 

Knowing where the tone generator registers are located is very helpful if you want to write a 
machine language subroutine for the sounds and/or music that you need for your program. Some 
of the arcade games play music while the program is running. It is possible to write a machine 
language subroutine that uses the vertical blank to produce music. The procedure is very similar 
to the one used in the last chapter to display two screens at the same time. 


Listing 10-5. Music: Machine Language Subroutine 


4 


10 REM LISTING 10.5 

20 REM MUSIC •••• MACHINE LANGUAGE SUBRDU 
TINE 

30 REM BY L * M <■ SC EIRE I BEE FOR TAB BOOKS 
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Listing 10-5. Music: Machine Language Subroutine (continued from page 157) 


4 0 A »• P E E K (10 6 ) •••• 1 1 ft E M S A V E 2 5 6 B Y T E S 
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60 GRAPHICS OJREM RESET THE SCREEN AND 
DISPLAY LIST 

70 POKE 206 ri: POKE Or 201ft EM SET THE I..E 
NOTH OF THE NOTE PLAY 

80 POKE 207 v 0 t REM OFFSET FOR THE NOTE 
BUFFER 

9 0 P 0KE 20 3 t 0 i P0 K E 20 4v At ftE M AD D ftE SS 0 
F BUFFER FOR NOTES 

10 0 B U F ~ A * 2 5 6 1 0 F F= 19.1. 1 ft E M B E GIN NIN G 0 F 
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96y 205 9 203y2 vi60 y255? 200 ? 132y207 

15 0 D A T A 141 9 0 y 210 y .1.0 4 y 7 6 y 9 5 y 2 2 8 

16 0 F 0 R X = 15 7 0 T 0 15 81 l R E A D C i P 0 K E X ? C 
t NEXT X 

.1. 7 0 1.1 A I A 1 0 4 y .1. 0 4 y 1 0 4 y 1 6 3 y .1. 0 4 y .1.0 4 y 1 7 0 y 1 

04y104y76y92y228 

180 Q = USR(1570 y 0 y 6 y 6) 

:l. 9 0 ? P E E K < 2 0 7 ) i *' 0 F F S E T H y P E E K ( 20 6 > y " C 0 
UNTER" 

200 GOTO 190 


Line 40 moves the end of memory down by 256 bytes. This is the area that will be our buffer 
for the music. The music buffer can be as large or small as needed. This program will restrict the 
length of the melody to 256 bytes. 

Line 50 pokes this new end of memory value into location 106. Now the computer will not use 
the last page of memory. 

Line 60 resets the screen and the display list using the value in 106 as the end of memory. 

Line 70 pokes a 1 into location 206. This location will be used as the timer or duration of the 
note being played. We set it to a 1 to begin with as a dummy value. Location 0 will hold the 
duration value. Location 206 will change while the program is being executed. Every time it 
counts down to 0, the computer will have to restore the duration value for the next note. Location 
0 will not change when the program is executed. 

Line 80 uses location 207 as the offset for the buffer. This location will increment every time 
a note is played. By adding the number in this location to the beginning address of the buffer, the 
computer will always know where the next note is. 

Line 90 sets locations 203 and 204 to the buffer address. Location 203 is set to 0 because we 
know that the music buffer begins on an even page. Location 204 is set to the high order byte of 
the beginning of the music buffer. Since we set the last page of memory aside for the music buffer, 
this value is poked into location 204. 

Line 100 computes the decimal address of the first byte of the music buffer by multiplying the 
value of A by 256. The variable OFF is set to one less than the number of notes that will be played. 

Line 110 is the for... next loop that moves the data on the next 12 lines into the music buffer. 
Each number in the data lines represents one note. 

Line 130 reads the machine language subroutine into page 6 of the computer’s memory. This 
is the routine that will be executed everytime the vertical blank is executed. Be sure that the data 
in lines 150 and 160 are entered correctly. If there is an incorrect number in the routine the 
system will crash or lock up. 

Line 160 places into memory the machine language subroutine that will initialize the routine 
that runs during the vertical blank. Again, it is important that the line of data is entered correctly. 

Line 180 executes the second machine language subroutine. The beginning address of the 
vertical blank routine and the type of routine is passed to the machine language subroutine with 
the USR command. 

Line 190 simply prints the offset value from location 207 and the counter or duration value 
from location 206. Every time the number in 207 changes, the note will also change. Once it 


% 
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reaches the 191st note of the melody, it will reset to 0. The counter shows how long the note is 
being held. Every time it reaches 0, a new note is pointed to by location 207. 

To stop this program, you must press the system reset key. If you press only the break key, 
you will only stop the BASIC program. The machine language subroutine running in the vertical 
blank will not be affected. 

By experimenting with different distortions, durations, and frequencies, you can change the 
entire effect of the melody. 
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Chapter 11 

Interpreting 
the Keyboard 


There are times when a simple input statement is not the best way to get information from the 
keyboard: the program may not lend itself to question marks on the screen; you may want single 
key input; or you may want the program to continue with its task and the keyboard to be read only 
when a key is actually pressed. (This is sometimes called reading it on the fly.) 

When you use the input command to retrieve information from the keyboard the program 
stops and a question mark appears on the screen. The entry is placed in either a string or a 
variable. If letters or other characters are entered into a numeric variable instead of numbers, an 
error will result. This can be resolved by using strings for all inputs. The input can be checked 
only after the return key has been pressed. Using this command is the simplest way to get 
information. It is used most often. 

The second method of getting an entry is with the get command. Although the program must 
still stop to get the input, this method is much faster than the previous way. The characters 
entered can be screened immediately. If the character is not correct, the program can disregard it 
and wait for another entry to be made. The buffer length can be set for any length, and when full, 
the program can continue without waiting for the return key. The keys pressed do not have to 
appear on the screen. 

The following program is a useful routine that can be used in any program that needs a 
read-keyboard routine. 


Listing 11-1. Read the Keyboard 


1 0 R E M LIS TIN 0 . 1 . 1 * 1 

20 REM READ THE KEYBOARD 

30 REM BY L*M*SCMREIBER FOR TAB BOOKS 

40 DIM BUFfcCLO) 

5 0 P 0 K E 7 5 2 * 1 : ? " > “ t 0 P E N # 2 5 / 4 y 0 y H K } " i R 
EM CLEAR SCREEN •••• OPEN KEYBOARD FOR A 
R E A D 

60 FOR X=1 TO 10iREM BUFFER IS 10 CHAR 
A C T E R S !... 0 N 0 
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Listing 11-1. Read the Keyboard (continued from page 161) 
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Line 40 sets the buffer length—(BUF$) to 10 characters. 

Line 50 removes the cursor, clears the screen, and opens the keyboard for a read. 

Line 60 begins the for . . . next loop that will accept keyboard input without using a return 

key. 

Line 70 waits for a key to be pressed. The keyboard must be opened before the get command 
will work. The ATASCII value of the key pressed will be placed in the variable B. 

Line 80 checks the value of B. If it is greater than 127, the ATARI or inverse key was 
accidentally pressed. Correct this by poking 0 into location 694. Subtract 128 from the value of B 
to get the normal code for the key pressed. 

Line 90 checks the value to see if it is upper or lowercase. If the caps/lower key was pressed, 
all the inputs would be in lowercase. Rather than check each key against 2 values, it is easier to 
subtract 32 from the value in B and reset the keyboard for uppercase by poking location 702 with 
64. 

Line 100 now checks the value of B to make sure that it is a letter. If the ATASCII value is 
less than 32, it is not a letter, and the program goes back to line 70 to wait for another input. The 
key that was pressed is disregarded completely. It is not displayed on the screen and it is not 
stored in the buffer. 

Line 110 places the letter for the key pressed into BUF$. As each correct key is pressed and 
entered, the value of X will increase. This will point to the next vacant position in BUF$. 

Line 120 places the letter on the screen. The row is set, the column position will increase 
with X. 

Line 130 prints BUF$ on the screen under the letters that were printed as they were 
pressed. BUF$ contains exactly what was printed on the screen. If any numbers or control 
characters were pressed, they were ignored by the program. 

Line 140 closes the keyboard. 

In the next program, we will use this input routine for a tile game. This game is based on the 
5x5 letter tile game. Each tile can only slide to a vacant spot. Try to arrange the letters correctly. 
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Listing 11-2. Tiles 
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Listing 11-2. Tiles (continued from page 163) 
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Line 40 sets aside 25 bytes for the letters (BUF$) and one byte for a temporary storage 
(TEMP$). 

Line 50 places the first twenty-four letters of the alphabet into BUF$. The twenty-fifth letter 
is the space. 

Lines 60-80 shuffle the letters. A random letter (R) is picked. That letter is placed in TMP$. 
The last letter minus the value of X is placed in the random position. The letter in TEMP$ is 
moved to the position that was just vacated. The loop continues until all the letters have moved 
five times. This method ensures that all the letters in the string will be thoroughly mixed. 

Line 90 sets the screen for graphics mode 2 with no text window. 

Line 100 places all the letters in BUF$ in a 5 x 5 grid on the screen. The variable X will point 
to the letter in the string. R is the row and C is the column. To center it on the screen we begin 
with the 4th row and 7th column. 

Line 110 increments X each time a letter is printed. This moves the pointer up one letter. 
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The loop continues until all the letters have been printed. 

Line 130 prints the direction on the screen. First a letter must be pressed. The keyboard is 
opened for a read. 

Line 140 sets the value of the key pressed and closes the keyboard. 

Line 150 checks the value of B. If it is greater than 127, then the inverse or ATARI key has 
been pressed. 127 must be subtracted from this value and location 694 must be poked with a zero 
to set it back to normal. 

Line 160 checks to see if the value is for a lowercase letter. If it is, 32 is subtracted from the 
value and location 702 is poked with a 64. The keys pressed now will be returned as upper case. 

Line 170 checks the value of B. If it is not a letter between A and X the program will return to 
line 130 for another input. 

Line 180 finds the position of the letter pressed in BUF$. The value of X will be its position. 

Line 190 sends the program back to line 130 for another input if the letter is not found. 

Line 200 calculates the row of the letter. The value of X minus 1 is divided by 5. The integer 
of the result is added to 4. Since there are 5 letters in each row, dividing X by 5 will give the row 
number. However, the fifth letter in each row would be put in the wrong row. By subtracting one 
from X, the resulting integer is the correct row (the first row is counted as row 0). Since we began 
printing the letters in position 4, this number is added to the result. Now we know which row on 
the screen the letter is in. 

Line 210 calculates the column. 4 is subtracted from the value of X to give the true row. This 
answer is multiplied by 5 (there are 5 letters in each row) and the result is subtracted from the 
position that X is pointing to. This answer is added to 6 because it will be in the range of 1-5. The 
columns on the screen begin with position 7. Now that we know where the letter is located on the 
screen, we can get a keystroke for the direction that the letter should be moved. 

Line 220 opens the keyboard for a read. A short tone will indicate that the program is ready 
for another input. 

Line 230 prints the new message on the screen. This time the program wants an arrow key to 
be pressed. When a key has been pressed, the computer will close the keyboard. 

Lines 240-270 will send the computer to the correct routine depending on whether the up 
arrow, down arrow, right arrow, or left arrow was pressed. Actually, the code that the program is 
comparing the inputs to are for the asterisk, the minus sign, the equals sign, and the plus sign. By 
using these codes instead of the control-arrow codes, the program is truly a one keystroke 
program. 

Line 280 sends the program back to line 220 if an arrow key was not pressed. 

Line 300 checks to see if X is pointing to 25. If it is, then it is at the end of the buffer and the 
letter cannot be moved to the right. The program will send the computer back to line 130 for 
another letter input. 

Line 305 checks to see if the next place in the buffer is empty. It also checks to see if this 
letter is in the fifth column on the screen. If either of these conditions are true, then the letter 
cannot move to the right, and the computer will go back to line 130 for a new letter. 

Line 310 erases the letter from its position on the grid and moves it over one to the right. 
Then it moves the letter up one space in the buffer. The position that the letter was occupying 
becomes a space. The program continues with line 130. 

Line 320 checks to see if X is the first position. This routine moves the letters to the left. If 
the letter to be moved to the left occupies the first position in the string, it cannot be moved to the 
left. The program returns for another letter input. 
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Line 325 checks to see if the letter occupies the first column of the grid. It also checks the 
position just before it in the buffer. If this position is full the letter cannot be moved to the left. If 
the letter cannot be moved because of either of these conditions, the program waits for another 
input at line 130. 

Line 330 uses the same procedure, but in reverse, to move the letter to the left. The letter is 
first erased from the screen, and then reprinted in the new position. The letter is moved down one 
position in the buffer and the old position becomes a space. 

Line 340 checks to see if the row (R) is 4. If it is, then the letter is in the top row. This routine 
moves the letter up one row. A letter in the first row cannot be moved up. 

Line 345 checks the buffer five positions before the position of the letter that will be moved. 
The letter will move up one row. The square that it is moving to is five positions before its 
position. If that position is not empty, the program will go back and wait for a new command. 

Line 350 erases the letter from the grid and reprints it one row up. It then moves the letter up 
five positions in the buffer and replaces it with a space. 

Line 360 checks the value of the row (R) to see if it is the last row of the grid. This routine 
moves the letter down one row. The letters cannot be moved past the last row. 

Line 365 checks the buffer five positions past the letters position to make sure that it is a 
space. If it is not, the program will go back to line 130 for another entry. 

Line 370 erases the letter and prints it one row down. It then moves the letter over five 
positions in the buffer. The letter’s original position becomes a space. 

This entire game is played with single keystroke entries. There are actually two entries for 
each move, but each is treated separately. If the first entry is correct, the program will ask for the 
second. Inputs that are not considered legal are ignored. 

KEYBOARD CODE 

The third method of entry from the keyboard is to read the keyboard on the fly. This means 
that the computer is busy running the program, but it keeps checking to see if a key was pressed. If 
it was, then it will process that information. If no key was pressed, it will continue with the main 
program. 

This method could be used in a game where the computer is working out some possible 
moves. If the player had to wait for the computer to make its move after the player made his/her 
move, the game could be excessively long. If, however, the computer could do its thinking while 
the player did, the time that the computer needed for its moves would appear to be shortened. A 
chess game is a good example of a situation where you would want the computer to think while the 
player did. 

The keyboard code is not ATASCII. It does not seem to follow any pattern. The only 
exception is that there is one bit set in the code if it’s an uppercase letter, or if the control key has 
been pressed. Table 11-1 shows the hardware key code and the corresponding key. Try the 
following one line program: 


10 ? PEEK(764),:GOTO 10 

There will be a stream of 255s on the screen until a key is pressed. Once a key has been 
pressed, that value will be printed on the screen until another key has been pressed. This is the 
hardware code for the keys. To convert the keycode into ATASCII so that you would know which 
key was actually pressed could be done with all the possible characters in a string buffer. There is 
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no need to do duplicate work. Beginning with memory location 65278, all the ATASCII codes are 
listed according to keycode. 

The following program will show you the internal or hardward code of the key and the 
character. 

Listing 11-3. Keyboard Conversion 
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Line 40 sets the variable CONVERSION to the first byte of the ATASCII values. This 
location is the ROM or the operating system. 

Line 50 clears the screen and removes the cursor. 

Line 60 asks you to press any key with the exception of the break key. 

Line 70 loops until a key has been pressed. When a key has been pressed, the value of 
location 764 will not be 255. 

Line 80 stores the value of location 764 in variable KC. Location 764 is poked with 255. This 
clears it for another input. 

Line 90 prints the internal or hardware code for the key that was pressed. Be sure to enter 
six spaces and five escape control-backarrows in the print line. This will erase the previous code 
from the screen. 

Line 100 adds the keycode to the first byte of the table in ROM. The program then prints the 
character of the peek of that location. This character will be in lowercase unless the shift key or 
control key was pressed for the input. 

Line 110 loops back to line 60 for another entry. 

Because of this table in ROM, it is very easy to convert keycode into the actual ATASCII 
values for a program. 
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READING THE KEYBOARD 

The following program is an example of how the keyboard can be read while the computer is 
executing a main program. This simple keyboard program will keep letters flying across the 
screen. If you press the correct letter, the letter will stop and you will be awarded points. The 
entire time that the letters are moving across the screen, the computer is checking location 764 to 
see if a key has been pressed. 


Listing 11-4. Letter Attack 
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Line 40 sets the variable CONVERSION to 65278. This is the first byte of the ROM table to 
convert the internal or hardware code into ATASCII. 

Line 50 sets the screen to mode 2 with no text window. The variable TL will be used in the 
timing loop. It can be changed to any number to make the letters move faster or slower. 

Line 60 chooses a number for the letter that will fly across the screen. It chooses a number 
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from 0-25 because there are 26 letters in the alphabet. This number is added to 65. The letter A is 
AT ASCII 65. 

Line 70 prints the current score on the screen. This line will update the score after every 
letter. 

Line 80 picks a random row for the letter to travel on. The letter cannot be on the 0th line 
because that’s where the score is printed. 

Line 90 begins the for... next loop that moves the letter across the screen. The letter begins 
on the left side of the screen and continues across to the right. 

Line 100 begins the timing loop. If there was no timing loop, the letter would travel across 
the screen too fast to be read. 

Line 110 checks location 764 for a value other than 255. If no key has been pressed, the 
computer is directed to line 140 to continue the timing loop. 

Line 120 stores the value of location 764 in the variable KC. The location is cleared by poking 
it with 255. 

Line 130 checks the key pressed with the letter that is being displayed. The program looks at 
the peek of the keycode added to the first byte of the ROM table. Since this is the lowercase 
ATASCII code for the letter, 32 must be subtracted from the code. If this result is equal to the 
value of KC, the correct key has been pressed. A new score is calculated by adding 20 (20-X) to 
the old score. X is the horizontal position of the letter at the time the correct response key was 
pressed. The variables T and X are set to their highest values and the for ... next loop continues. 
Since T and X are at their limit, the program will continue with line 160. If the letter reaches the 
edge of the screen, it will be erased from the screen. If the correct key has been pressed, the 
letter will stop on the screen and remain there until another letter erases it. 

Line 160 sends the computer back to line 60 for another letter if the score is less than 1000. 

Line 170 will end the game if the score reaches or surpasses 1000. The screen will clear and a 
message will appear. The ending score will also be printed. 

Line 180 asks if you want to play again. The keyboard is opened for a read. 

Line 190 gets an input from the keyboard and closes it. If the letter Y has been pressed, the 
program will subtract 5 from the counter and go to line 60 for another game. Each time a new game 
is played, the letters will fly faster on the screen. If any other key is pressed, the program will end. 
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Chapter 12 


Understanding 
the Screen Editor 


Everything that you see on your screen is processed by the screen editor. It keeps track of where 
the cursor is, where the screen memory begins, whether or not there is a text window, the tab 
locations, the mode the screen is in, the right and left margins, etc. This chapter will list most of 
the memory locations that the screen editor uses and the function of each location. These 
locations can be changed by the program. If they are changed correctly, they can add features to 
your program. If they are not, the program could crash or produce results that are less than 
desirable. 

GET/PUT CHARACTERS 

When the program contains the locate command, it is getting a character from the screen. 
This command contains the row and column that you want looked at. It returns the ATASCII value 
of the character at that location. 


Listing 12-1. Locate, Poke, and Peek 


10 REM LISTING 12,1 
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Line 40 sets the graphics mode and clears the screen. The graphics command must before 
using the locate command. 

Line 50 prints the letters of the alphabet across the screen. 

Line 60 uses the locate command to get the ATASCII value of the character in location 2,0. 
The value will be stored in variable B. Immediately after using the locate command, the character 
must be printed back into that location. When the location is examined for its contents, the 
location becomes blank. To reinstate the character, the print command must be used. 

Line 70 shows the ATASCII value of the character at the location 2,0. 

Line 80 calculates the beginning address of the screen. This address is stored in locations 88 
and 89. 

Line 90 uses the peek command to look at that memory location. This time the result is not 
the ATASCII value, but the position of the character in the character set. 

Line 100 prints this value on the screen. 

Line 110 pokes this value back into memory. The location that will be poked is 40 more than 
the address that was peeked at. This will move the character down one line. 

As you can see, you can get different results depending on which commands you use to look 
at a character on the screen. The locate command is the easiest to use since it calculates the 
screen position, and returns the ATASCII value of the character. There may be times, though, 
when the program that you are writing will work better with pokes and peeks. 

CONTROL CHARACTERS 

There are sixteen control codes for the ATARI computer. Each of these codes has its own 
ATASCII value. They can be printed to the screen within a string, within quotes, or with the 
CHR$ command. The following list gives the ATASCII code for the control codes and their 
function. 

ATASCII code Command and function 

(decimal) 

27 Escape: The character following this code will be treated as data. This means 
that if the next character you want is a control character (for example, clear 
screen), pressing the escape key first will display the character rather than 
clearing the screen. Use the escape key when there are control characters in a 
string or line that will be printed on the screen. 

28 Cursor up. The cursor is moved up one line on the screen. If the cursor is on 
the top line, it will appear on the bottom of the screen. This key is used in 
editing. Under program control it could space messages that are printed on the 
screen without using the position command. 

29 Cursor down. This code moves the cursor down one line on the screen. If the 
cursor is on the bottom line, it will move to the top of the screen. Again, this can 
be used instead of the position command, when you are printing text on the 
screen. 

30 Cursor Left. This code moves the cursor one position to the left. If the cursor 
is at the left side of the screen, it will move to the right side of the screen, but 
remain in the same screen line. This character is often used to clear a previous 
input to the same prompt. If the previous line prints three or four spaces, then 
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ATASCII code Command and function 

(decimal) 

printing one fewer cursor-left character will clear any information that was on 
the line, and the question mark will appear in the correct position for the next 
entry. 

31 Cursor Right. This code moves the cursor one position to the right in the 

same line. If the cursor is at the right edge of the screen, it will move to the left 
edge in the same line. 

125 Clear. This code represents one of the most frequently used control charac¬ 
ters. It clears everything from the screen and homes the cursor. The home 
position of the cursor is the upper left corner of the screen. 

126 Backspace. This code moves the cursor back one space. If the cursor is at the 

left margin, and this line is the beginning of a logical line, the cursor will not 
move any further. If this line is the continuation of a previous line, the cursor 
will move to the right edge of the screen one line higher. (There are three 
screen lines to one logical line.) When the cursor moves to the left, it removes 
or deletes the characters on the screen. 

127 Tab. This code moves the cursor several positions to the right. The tab 

positions are set when the computer is turned on. They can be reset under 
program control. The computer considers three screen lines to be one logical 
line for the tab function. 

155 End of Line. This code ends the logical line for the computer. It is also used to 

indicate that the return key has been pressed to enter an input. When the 
screen editor receives an end-of-line (EOL) it returns the cursor to the left side 
of the screen, one line down. Printers usually use this code to issue a carriage 
return and line feed. Disks and cassettes use it to indicate the end of a record. 

156 Delete Line. This code removes all the information that is on the line that the 
cursor is on. This line is cleared on the screen. If there is text printed below the 
line, all the lines move up one line. 

157 Insert Line. This code adds a blank line in the line that the cursor is in. If there 

is information in this line, it and any text below it are moved down one line. Any 
information on the last line of the screen will be moved off the screen. 

158 Clear Tab. This code removes the tab indicator from the point that the cursor 

is at. If the tab was not set at this location, nothing happens. There is no 
clear-all-tabs command, but this function can be accomplished with pokes. 

159 Set Tab. This code places a tab indicator at the location of the cursor. Since the 

tabs can be set for three screen lines, it is important to know exactly where the 
cursor is. 

253 Bell. This code makes a tone using the speaker on the computer. This sound is 

more like a squawk than an actual bell. This character has no effect on the 
display. 

254 Delete Character. This code removes the character “under” the cursor. If 
there are characters in the line to the right of the cursor, they will move one 
position to the left. If the logical line is longer than one screen line, the contents 
of the lines below the line with the character that is being deleted will move up 
also. 
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ATASCII code 
(decimal) 


Command and function 


255 Insert Character. This code adds one position to the line. A space is inserted 

at the position of the cursor. The character under the cursor and any characters 
to the right of the cursor are moved one position to the right. 

In some programs, it is possible to place machine language subroutines into strings. If it is a 
relocatable subroutine, this is a good place to store it since it can be accessed by using the 
USR(ADR(STRING$)) command. But, very often, some of the codes for the subroutine are the 
control codes listed above. If you try to print the string, you may find that you cannot see all the 
characters in it because the control characters don’t print! The next program shows you which 
location to poke to make control characters visible on the screen. 

Listing 12-2. Printing Control Characters 


•••) 


10 REM LISTING 12 
20 REM PRINTING CONTROL CHARACTERS 
30 REM BY I... * M * SCI-IREI BEE EOR TAB BOOKS 
40 DIM A $(20) 

5 0 A $ “ " > > " : R E M P U T C 0 N T R 0 L C H 
AEACTEES IN THIS STRING 
60 POKE 766*1 

70 ? "A $ CONTROL CHARACTERS 
SO POKE 766*0 


II ~ 


9 R$ 


Line 40 sets aside 20 places for characters in A$. 

Line 50 places an assortment of control characters into A$. These are - bell, clear, insert 
character, delete character, cursor down, cursor up, cursor right, cursor left, tab, insert line, and 
delete line. To print these characters within the quotes, use the escape control keys for all but the 
last two; use the escape shift keys for those. 

Line 60 pokes location 766 with a 1. Anytime this location is not zero, the control characters 
will be printed on the screen as characters. 

Line 70 prints the contents of A$ on the screen. If you do not clear the screen before running 
this program, you will see that A$ is printed exactly as it is set in line 50. 

Line 80 resets location 766 with a 0. Now if you try to print A$, you will get the bell, the 
screen cleared and all the other control characters executed. 


OTHER MEMORY LOCATIONS 

The following list of memory locations are used by the screen editor, display handler, etc, to 
display information on the screen. They are all located in RAM, so they can be changed under 
program control. Some values may be immediately reset by the operating system; others will be 
ignored; and changing some can cause strange results, or make the system crash. 

Memory Function 

Location 

88,89 This is the beginning of the screen memory. When the contents of these locations 
are changed, the computer will print in memory other than that being displayed on 
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Memory 

Location 


Function 


the screen. This location was changed in the program Slide Shows (Chapter 9). 

675 This byte and the next 14 bytes make up the bit map for the tab. Every bit that is 
set is a tab. For example, input POKE 675,17. Now press the tab key. The cursor 
will stop under the E in READY—the fourth screen position, and under the space 
after the Y—the eighth screen position. All tabs can be cleared by this statement. 

FOR X=675 TO 689:POKE X,0:NEXT X 

694 This location sets or clears the inverse flag. If this location is 128, all the 
characters will be treated as inverse characters. It must be set to 0 for normal 
characters. This location was used in Chapter 11. 

702 This location is set for lower or uppercase letters. If this location is 64, the 
shift-lock has been set and the characters are uppercase. If it is 0, the characters 
are lowercase. This location was also used in Chapter 11. 

703 This location can only be 4 or 24. If it is 24, it sets the normal screen size. A 4 sets 
the text window at the bottom of the screen. Poke this location with a 4; then list a 
program. The entire program will scroll in the bottom four lines of the screen. 

By experimenting with these locations, you will learn how to create the effects that you need 
or want for your programs. 


175 




Chapter 13 


Disk Use 


Convenient program and data storage is provided by the floppy disk system available with the 
ATARI. By understanding how the computer handles the disks and how the disks themselves are 
organized, you can better control and utilize the system. 

DISK FILE MANAGER 

The file manager provides the commands that allow BASIC to access the disk drive. Up to 
four drives can be accessed with the manager that comes with the ATARI Disk Operating System 
(DOS). Throughout this chapter and the next, the ATARI DOS will be used for the examples. If 
you are using a different DOS on your system, some of the commands or formats may differ. 

lOCBs 

The ATARI computer has a portion of memory set aside for input and output control. This 
area of memory is called the input/output control buffer (IOCB). The memory locations in this 
area are set for the device(s) that will be handled. This area is not exclusively for the disk drives. 
It can also be used by the screen editor, cassette, or any other device that can access it. It can also 
be used under program control. 

The IOCB stores information concerning the device that is being used, the process that will 
be performed (writing to the device or reading from it) the length of the buffer that will be written 
from or read into, and location of the buffer. 

CIO Functions 

The central input/output (CIO) functions control most of the disk operations. Each disk 
operation has its own specific function. Some operations have options that can be accessed by 
using the correct auxiliary code. 

Open. The open command can be used to create a new file, append an existing file, or update 
an existing file. The file can also be opened for a read. To use the open command, you must specify 
which drive, the name of the file and the option, for example, OPEN #2,8,0,“D:NAMES”. The 
file NAMES would be opened using buffer #2. It is opened for a write only. If a file already exists 
with that name, it will be written over. If it does not exist, it will be created. Its name will be added 
to the directory. 

Using the format OPEN #2,9,0,“D:NAMES” opens the file for an append. The file will not 
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be destroyed. The information sent to it will be placed immediately following the data that is 
already there. 

If you use the format OPEN #2,12,0,“D:NAMES”, the file will be opened for update. Any 
part of it can be changed without affecting the rest of the file if the file was created properly. 

You can also use the open command to read the directory from BASIC by using OPEN 
#2,6,0,“D:*.*”. In the next program, you can read the directory from BASIC and run any program 
by entering that program’s number. 


Listing 13-1. Directory Listing 


10 REM LISTING 13*1 

20 REM DIRECTORY LISTING 

30 REM BY L.M.SCHREISER FOR TAB BOOKS 
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COLUMN r NEXT ROW 
130 NEXT XI REM FINISH DIRECTORY 
140 TRAP 140JPOSITION 2?22?? "ENTER NU 
MBER OF PROGRAM "5?INPUT P 

- P>N OR PCI. THEN 140 
U F $ (1) = “ " ? B U F T (14 ) = " " ? B U F * < 2 >= B 
U F $ = ' ■ ? B U F $ = 11 B ? 11 ? F 0 R X=P >K 12 -11 T 0 
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Line 40 sets aside 768 bytes for the directory and 14 for the buffer. There is a maximum of 64 
files that can be stored on disk. There are 12 bytes fielded for each file. 

Line 45 clears the garbage from the string. 


178 
















Line 50 clears the screen. 

Line 60 opens buffer #2 to read the directory. The number 6 indicates a directory read. The 
asterisks (*) are used for the file name so that all the file names will be read. The variable N will 
record the number of files read. X will point to the position in DIR$ that the file name will begin at. 

Line 70 gets an input from buffer #2. The contents of this input is stored in BUF$. The 
program is reading the entry from the buffer, not from the disk. 

Line 80 places the contents of BUF$ into DIR$. All the file names will be stored this way. 

Line 90 checks the first character of BUF$. If it is a number, there are no more files in the 
directory. One is subtracted from N so that N will be the number of files listed in the directory. 

Line 100 adds 12 to the value of X. This moves the pointer up 12 bytes to point to the 
beginning of the next field. The variable N is incremented by 1, and the program continues with 
line 70. 

Line 110 uses the variable R to indicate the row that the file information will be printed on 
and the variable C for the column. The for....next loop accesses DIR$ to print the names of the 
files on the screen. The column position is calculated to keep them straight. When X is greater 
than 10, the number (X) must be printed one column to the left to keep the numbers in a straight 
line. The logical operation NOT returns a 1 when the integer of C/10 is 0. It returns a 0 when it is a 
number greater than 0. By adding this value to the variable C, we can keep the numbers in a 
straight column. The number (X) of the file and the file name are printed on the screen. Again, X is 
used to calculate the beginning and ending positions of the file name. 

Line 120 recalculates the value of C. The two positions that the column can be are 2 and 22. 
By subtracting the value of C from 24, the variable C will be 2 and 22 alternately. Everytime C is 2, 
the variable R is incremented so that the next file name can be printed in the next row on the 
screen. 

Line 130 continues the loop. 

Line 140 asks for the number of the program that you want to run. The line ends with five 
spaces and three backarrows. The trap keeps the program from crashing if a letter or other 
character is entered instead of a number. The number of the program is stored in the variable P. 

Line 150 checks the value P. If it is larger than the number of the last program on the screen, 
or less than 1, the program returns to line 140. 

Lines 160-180 place the name of the program into BUF$. The first two characters of the 
string are set to D:. This is the code that the computer needs to access the disk. The program 
looks for the first space. The part of the name from the first character to the character before the 
first space is placed in BUF$. 

Line 190 places the . after the name of the program. The extender is added to the name. 

Disk Buffer 

Located in the IOCB is the address of the disk buffer. When the computer inputs information 
from the disk, it moves the data into the buffer. When the program uses the get.command or put 
command, it goes into this buffer to retrieve or place information. The get and put commands 
work with only one byte at a time. 

The input command also gets its information from the buffer. All the data up to the end-of-line 
code is placed into the string. If the string is not long enough for the information, it will be lost. 

The following program will print a hard copy of a program that has been listed to the disk. 
The length of the line can be specified. The program uses the data in the disk buffer to print the 
listing. 
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Listing 13-2. Print from Disk 


10 

20 

30 

40 


5EM LIST 13,2 

'<EM PRINT FROM DISK 

\'EM BY L , M♦SCHREIBER FOR TAB BOOKS 

? 11 >CLEAR'.TENTER THE LENGTH OF A LIN 


:INPUT PL 

? "ENTER THE NUMBER OF LINES TO A P 

ii •' * 


5 1 INPUT LN 


E" 5 
50 
AGE 

60 OPEN #2p S v 0»"R4 
70 

8 0 L ~ 1 


* II 


0 P E N # 1 9 4 y 0 9 " D i L IS TI N G " 


90 TRAP 300iFOR C«1 TO PL 
100 GET #1 v B 

? #2yCHH$ <B) y 

IF B=155 THEN 140 
NEXT Ci? #2yCHR*<155)J 
L~L + :L i IF LCLN THEN 90 
FOR L1 TO 10 i? #2 i NEXT- 
CLOSE #1JCLOSE *2:END 


110 
. 1.20 
1.30 
140 
150 
300 


LJGOTO 



Line 40 clears the screen and asks for the length of the line. This value is stored in variable 
PL. It can be any value. Of course, if your printer can only print 40 characters on a line, a number 
larger than 40 would not work. 

Line 50 asks for the number of lines to a page. This is the number of lines that you want 
printed at one time. After every page, the program will print ten line feeds to separate the pages. 

Line 60 opens buffer #2 for the printer. The printer that I use is a serial printer out of port #4 
of the interface. 

Line 70 opens buffer #1 to the disk drive. The program that you want printed should be listed 
to the disk with the LIST “D:LISTING” command instead of being saved. Use the name LISTING 
for the program. By listing the program to the disk, it is not saved in the token form, but byte for 
byte the way it appears on the screen when it is listed. 

Line 80 sets the variable L to 1. This variable will count the number of lines that are printed. 

Line 90 sets a trap for line 300. We don’t know how long the program is, so when an error 
occurs, we will end the program. The for....next loop to print the program begins here. 

Line 100 uses the get command to retrieve a byte from the buffer. The disk will turn on and 
256 bytes will be read into the buffer. This command will get each byte from the buffer one at a 
time. It keeps track of which byte it got last, so it always gets the next byte. When the end of the 
buffer is reached, the next 256 bytes will be read in off the disk. 

Line 110 prints the CHR$ of the byte to the printer. The semicolon after the CHR$ keeps 
every character on the same line until the carriage return and line feed (EOL) is issued to the 
printer. 

Line 120 checks the value of B. If it is 155, the EOL has been sent to the printer, and the 
printer has returned to the beginning of the line and fed the paper up one line. The program is 
directed to line 140 since there will be no more characters printed on this line. 

Line 130 continues the loop. After the number of characters specified by PL is sent to the 
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printer, the program sends an EOL to the printer. If there are more characters for this program 
line, they will be printed on the next line. 

Line 140 adds one to the value of L. This is the number of lines that have been printed. If the 
number of lines required for one page have not been printed, the program will go back to line 90. 
This will start the for....next loop again. 

Line 150 will separate one page from the next. Ten prints will be sent to the printer. This 
number can be changed if you want more or less spacing between the pages. 

Line 300 closes the buffers and ends the program. 

SPECIAL FUNCTIONS 

There are some functions that can be accessed both from the DOS and BASIC. Although they 
are not supported by one word commands, they can be executed with the XIO command. They 
are: lock, unlock, delete, rename, and format. The XIO commands are: 


Operation 


LOCK 

XIO 

UNLOCK 

XIO 

DELETE 

XIO 

RENAME 

XIO 

FORMAT 

XIO 


Command 

35, #l,0,0,“D:name” 

36, #l,0,0,“D:name” 
33,#l,0,0,“D:name” 
32,#l,0,0,“D:name newname 
254,#1,0,0,“D1:” 


These commands can be used within a program to access the disk. The following program 
includes some of these commands and the note and point functions. 

Listing 13-3. Calendar 


10 REM LISTING 13*3 
20 REM CALENDER 

30 REM BY L♦M♦SCHREIBER FOR TAB BOOKS 
4 0 DIM D A Y $ ( 3 0 ) y B U F $ <20 > y M T f> (8) y TEM P $ ( 


n ■::: ) 

Am • 


50 ? "> CLEAR!)" ^POSITION 5 v 2 J ? "PLEASE 

c h o o s e : ■: p o s i r i □ n 5 y 4 : ? ■ :i. , f 0 r m a t n e 

W DISK" 

60 POSITION 5*6*? “2. CHECK CALENDER" 


7 0 T R A P 7 0 { P 0 SIT10 N 10 y 8 l ? “ " y 11N P 

IJT C i REM 2 SPACES & 2 LEFT ARROWS TO C 
LEAR ENTRY 

80 IF CCI. OR 02 THEN 701 REM ONLY ACCE 
PT .1. OR 2 

90 ON C GOTO 100*250 

100 P0KE 752y1 t ? “>CLEAR>" i P0SITION 2 * 
10:? "THIS SELECTION WILL FORMAT A DIS 
K FOR THE CALENDER PROGRAM. PLACE A” 
110 ? "NEW DISK INTO THE DRIVE AND PRE 
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Listing 13-3. Calendar (continued from page 181) 


SB RETURN ANY OTHER KEY WILL RETUR 

N YOU TO THE MENU" 

120 IF PEEK(764)=255 THEN 120 

13 0 L N=5 0 1I F P E E K ( 7 6 4 ) = 12 T H E N L N15 0 
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Line 40 sets aside space for the strings. DAYS will hold the day’s activity. BUF$ is used as a 
buffer for the disk file name. MT$ is the month and TEMP$ holds information temporarily. 

Line 50 clears the screen and places the first menu option on the screen. 

Line 60 places the second menu option on the screen. 

Line 70 places a question mark on the screen and waits for an entry. The trap will keep the 
program from crashing as a letter or other character is entered. Two spaces and two left arrows 
are printed before the input. This will erase the entry if the program does not accept it. 

Line 80 checks the value of C. If it is not a 1 or 2, the program will return to line 70. 

Line 90 branches to the correct routine. 

Line 100 removes the cursor and clears the screen. It prints part of the message on the 
screen. 

Line 110 prints the rest of the message on the screen. 

Line 120 waits until a key has been pressed. 

Line 130 sets the variable LN to 50. This is one of the two lines that the program can be 
directed to. If the return key was pressed, the value of LN changes to 150, the other line number. 

Line 140 clears the key input and sends the computer to the correct line. 

Line 150 formats the disk. It is very important that the disk in the drive does not have 
programs that you want to keep on it. When the disk is formatted, all the information on the disk 
will be erased. 

Lines 160-180 place the files for the months on disk. The X loop goes from 1 to 12. The month 
is read into BUF$. The contents of DAY$ are cleared, and the file is opened with the name that is 
in BUF$. Line 170 begins the second loop. This loop places a buffer for each day of the month on 


183 









the disk. The first byte(s) of the DAY$ contains the number of that day. The last byte is set to a 
blank space. The entire buffer is printed to the disk. After all the days have been printed to the 
disk, the file is closed and the X loop continues. 

Lines 190-200 contain the months in the format needed to open files on the disk. 

Line 210 puts the cursor back on the screen and returns to the main menu. The disk is now 
set up as a calendar. 

Line 250 begins the calendar routine. The screen is cleared, and the message to enter a 
month is placed on the screen. 

Line 260 restores the data line and begins the for....next loop to look for a match between the 
month entered, and the months on file. The contents of BUF$ beginning with the third byte is 
compared to the contents of MT$ (the month entered). If a match is found, the computer goes on to 
line 280. 

Line 270 continues the loop if no match is found. If the month cannot be found because of a 
spelling error, the program goes back to the main menu. 

Line 280 waits for a day to be entered. All the files are set up for 31 days. The entry here is 
not checked for a correct day. If you need more days in your year, here’s your chance to lengthen 
February! 

Line 290 clears the trap. The file for the month specified by BUF$ is opened for a read. The 
loop gets every day from 1 to 31. The program has no way of knowing where in the file the day is 
located. The note command places the sector number of the day being read into the variable S. 
The first byte of the day is placed in B. 

Line 300 checks the day in the buffer against the day entered. The loop continues until the 
days match. If no match is made, the file is closed and the program returns to the main menu. 

Line 310 closes the file if the days match. 

Line 320 clears the screen and prints the month and day entered on the screen. 

Line 330 places a blank line on the screen, then prints the contents of DAY$. 

Lines 340-360 print a mini-menu. If you want to keep the information that is on the screen and 
return to the main menu, press K. If you want to change the information, press the U. Press D if 
you want to check another date. 

Line 370 opens the keyboard for a read. When a key is pressed, the keyboard will be closed. 

Line 380 checks the value of C. If it is greater than 127, the inverse or ATARI key has been 
pressed. 128 must be subtracted from the value of C. A zero is poked into memory location 694 to 
reset the flag for normal text. 

Lines 390-410 check the value of C. If it is a K, the program will return to the main menu. If it 
is a U, the program will continue with line 450. Entering a D will send the computer back to line 
250 for another entry. 

Line 420 will send the computer back for another entry because the key that was pressed was 
invalid. 

Line 450 issues a blank line, and then asks for the new information to be entered. 

Line 460 clears any previous information or garbage from TEMP$. It then waits for a new 
input. If the length of the input is less than 25, the last character of the string will be set to a space. 

Line 470 asks you to verify what you typed. 

Line 480 opens the keyboard for a read. Once a key has been pressed, the keyboard will be 
closed. 

Lines 490-520 check the value of C. If a Y or an N was not entered, the program will loop back 
for another entry. If an N was pressed, the program will go back to line 450 for a new input. If the 


184 



entry is correct, the program will continue with line 530. 

Line 530 places the information from TEMP$ into DAY$. The last byte of DAY$ is set to a 
space. The disk is fielded for 30 bytes per record. If fewer bytes are sent back to the disk, the 
pointers would be changed, and we could not retrieve information from the disk. 

Line 540 opens the file in BUF$ for read/write or append. The point command is used to set 
the pointer to the correct sector and byte. The information in DAY$ must be placed back on the 
disk in the exact spot that it was taken from. 

Line 550 prints DAY$ to the disk and closes the buffer. After each update, the routine will 
return to the main menu. 


DISK HANDLER 

Another way to access the information on the disk is by using the disk handler. The disk 
handler is twelve bytes long and can transfer one sector (128 bytes) of data to or from the disk. In 
order to transfer the information, the disk handler must be set up by the program. The disk 
handler begins at memory location 768. It must contain the number of the disk drive that will be 
accessed, the command byte (get sector, put sector, format, or status request), the buffer 
address, and the number of the sector to be accessed. 

The next program will load in.a specified track from a disk and display it as characters on the 
screen. The characters can be changed, and resaved onto the disk. This program will not allow 
you to change the data on the disk, just to look at it. It will tell you the status of the track. If the 
status is not OK, it is a bad track. Either the information on it got scrambled, or it was made into a 
bad track for copy protection purposes. 


Listing 13-4. Displaying Sectors 


10 REM LISTING 13*4 
20 REM DISPLAYING SECTORS 

30 REM BY L*M*SCHREIDER FOR TAB BOOKS 

4 0 DIM BUFFER $ (128) t DROUT$(5) 

5 0 B U F F E R $ (1 > = " " i B U F F E R $ < 12 8 > == 11 " } B U F 

F E R $ C 2 ) = B U F F E R $ t R E M C L E A R T H E BIJ F F E R 
60 FOR X=1 TO 5JREAD BJDROUT*<X t X)=CHR 
$ (B)* NEXT X 

6 5 D A 1 A J. 0 4 v 3 2 y 8 3 y 228 ? V 6 

7 O A D D R ~ A D R < B IJ F F E R $ > £ R E M D E CIM A L A D D R E 
SS OF BUFFER$ 

8 0 B U F HI = IN T < A D D R / 2 5 6 > ?• R E M HIG H 0 R D E R 
B Y T E 

9 0 B U F L O -- A D .0 R - ( B IJ F HI * 2 5 6 "> ■> R E M L O W 0 R D E 
R BYTE 

10 0 D C B - 7 6 8 t R E M D1S P L A Y 0 O N T R 0 L C H A R A C 
TEES SET DEO ICE CONTROL BLOCK 

.110 P 0 K E D C B +1 y 1 { R E M D RIO E #1 

12 0 P O K E D C B ••}• 2 v 8 2 l R E M G E T S E C T O R 

13 O P O K E D C B+4 y B U FI... O £ R E M B E GIN NIN G 0 F 

BUFFER •••• LOW ORDER ADDRESS 
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Listing 13-4. Displaying Sectors (continued from page 185) 


140 POKE DCB+5 > BIJFI-II t REM BEGINNING OF 
BUFFER •••• HIGH ORDER ADDRESS 
150 POKE 766 r OMR A P 150 J? "INPUT SEC TO 
R NIJ M B E R " 5 11N P U T S E C T 0 R t P 0 K E 7 66 r 1 i R E M 
GET A SECTOR NUMBER 

16 0 S E C T 0 R HI = IN T ( S E C T 0 R /25 6 ) l R E M G E T H 
I6H ORDER BYTE OF SECTOR 

17 0 S E C T 0 R L 0 ~ S E C T 0 R - ( S E C T 0 R H1 1 25 6 ) t R E M 
GET LOW ORDER BYTE OF SECTOR 

18 0 P 0 K E D C B +10 i S E C T 0 R I... 0 t R E M S 

19 0 P 0 K E D C B+11 y S E C T 0 R HI 
2 0 0 X -• U S R ( A D R ( D R 0 U T * ) ) i R E M C A I... I. 

S* ROUTINE TO READ DISK 
210 D S T A T = P E E K ( D C B + 3 ) t R E M 


T 


IT 
0 ♦ 


T 


ST AT 
D S T A T ~ 1 


(« 


2 2 0 ? " DIS K S T A T U 8 * " 5 D S T A T i i IF 
THEN ? ■ - OK":GOTO 240 


230 PRINT t REM PRINT SECTOR IN FORM A TIC) 
N ON NEW LINE 

2 40 ? “ S E C T 0 R D A T A : " t ? B U F F E R « 

250 GOTO 150 


260 km 


Line 40 sets aside space for two strings. BUFFERS will contain the data in the sector. 
DROUT will contain the address of the machine language subroutine in the operating system that 
will use the disk handler. 

Line 50 clears the buffer. 

Line 60 reads the machine language subroutine into DROUT$. This subroutine is a jump to a 
subroutine in the operating system. We need this subroutine to access the operating system 
subroutine because we are accessing this subroutine through BASIC. The first thing that the 
subroutine must do is pull a byte off the stack. If we accessed the routine directly, it would not 
return properly since the byte would not be pulled off the stack. 

Line 70 places the decimal address of the first byte of the buffer into the variable ADDR. 

* 

Line 80 divides this number by 256. This integer is the high order address of the string 
location. 

Line 90 subtracts this number from the address. This gives the low order address. 

Line 100 sets the variable DCB to 768, the beginning of the device control block, and pokes 
location 766 with a 1. Now if there are any control codes in the sector, they will be printed on the 
screen. 

Line 110 pokes the second byte of the device control block with the number of the drive that 
will be read. 

Line 120 pokes the next byte with the command byte. 82 is the command to get a sector from 
the disk. 

Lines 130-140 place the low order and high order byte of the address into the device control 
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block. This address is the beginning of BUFFER$. 

Line 150 asks for a sector number. The trap is set for inputs that are not numbers. The sector 
number will be stored in the variable SECTOR. 

Lines 160-170 divide this number for the low order and high order bytes. 

Lines 180-190 place these bytes into the correct addresses of the device control block. 

Line 200 calls the machine language subroutine that calls the operating system’s disk 
interface routine. 

Line 210 checks the status of the sector read. 

Line 220 prints the status of that sector. If it is a 1, the sector was read incorrectly. 

Line 230 forces a line feed to the screen. There is a semicolon after the status value in line 
220. If the status was not OK, the line feed would not occur. 

Line 240 prints the sector on the screen. Some sectors look like they are displaying garbage 
on the screen. Others are a string of hearts, and still others are perfectly readable. 

Line 250 sends the program back to line 150 to get another sector to be displayed. 

Press the break key when you are finished displaying sectors. The following list shows 
which bytes are used for the DCB and which commands could be used. 


Address 

769 

770 

771 
772-773 

778-779 


Function 

This byte is set to the number of the drive that will be accessed (1-4). 
This is the command byte. The commands are: 82-get sector; 87-put sector 
with verify; 83-status request; 33-format disk. 

This is the status byte. After a successful read, this byte will be a 1. 

This is the buffer address that indicates where the data will be placed or taken 
from. 

This is the number of the sector that the routine will access. The sector could 
be written to or read from. 


FILE MANAGEMENT SYSTEM 

In addition to the disk file manager, there is also a file management system. This governs the 
format of the disk, the location of the boot record, the file directory, the volume table of contents, 
and any other information needed to keep files on a disk. If any or all of the files that the file 
management system (FMS) uses are destroyed, the disk may not boot, copy correctly, or read in 
the files. By understanding how the files are structured on the disk, bad sectors can be fixed; the 
table of contents can be altered; and files can be deleted or restored without using the disk file 
manager. 


Track Format 

When a disk is formatted, all the data on the disk is erased. There are 720 sectors on the disk. 
Every byte in every sector is set to 0. The first sector of the disk is reserved for the boot record. If 
there is no boot record, the disk will not load from a cold start. When DOS is written to the 
formatted disk, the boot record is written to the disk along with the DOS and DUP files. When the 
disk boots, it brings DOS into the computer. 

When a file or record is sent to the disk, it may require one or more tracks. The FMS begins 
with the first available sector and stores the program on subsequent available sector. The key 
word here is available. If, for example, a program used two sectors for storage; the next program 
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used four; and the third used five. Now, you delete the second program from the disk. Those four 
sectors are available for another program. The next program that you write needs 10 sectors. The 
FMS uses the first four sectors from the deleted program and the six sectors after the third 
program. How does it know where the rest of the program is??? 

Every sector of every program has its own linking bytes. There are 128 bytes in every 
sector. Bytes 1-125 contain the data for that sector. It could be a program listing, a file, or 
whatever else was saved to the disk. The 126th byte contains the file number. Every sector that 
pertains to this program will have the same file number. If there is a mismatch between file 
numbers, an error 164, file number mismatch, will occur. 

Byte 127 is the forward pointer. It contains the sector number for the next sector that has 
more data for this file. It usually is, but does not have to be, the following sector. This is how the 
computer knows where the rest of the program is. If sectors 4-8 are used for a program and the 
next available sector is 14, the number 14 will be stored in byte 127 on sector 8. When the 
computer finishes reading in the data from sector 8 it will continue on to sector 14 and skip sectors 
9-13. If this is the last sector for the file, this byte will be 0. 

Byte 128 is the byte count. It contains the number of bytes that should be read in from this 
sector. A full sector contains 125 bytes. Anything less than 125 is considered a short sector. 

If you use the Displaying Sectors program from this chapter, you can examine the sectors of 
the disk and see how the sectors are linked. 

Volume Table of Contents 

When you want to save a program onto the disk, the computer has to know where there is 
room to save it. It can’t sit there and examine every sector on the disk to decide whether or not the 
program should be placed there. Sector 360 is the volume table of contents (VTOC). Use the 
Displaying Sectors program to examine this sector. Now examine a newly formatted disk. 

The VTOC for the disk that has been used should have a string of hearts, with some inverse 
insert characters. The disk that was just formatted is almost filled with the inverse insert 
characters. This is a bit map that tells the computer which sectors have been used and which ones 
are empty. The fourth and fifth bytes of this sector indicate how many sectors are available. On a 
new disk these two characters should be an inverse C and a control B. This is a two byte 
number: 2*2564-195=707 free sectors. On a used disk, this number will vary. If the 4th and 5th 
bytes are set to 0, the computer would think that the disk is full. The bit map begins with the 11th 
byte or character. On the new disk, this byte will be 15, the character will be a control 0. The next 
44 bytes are inverse insert characters (ATASCII 255). The 45th and 46th bytes are a heart and 
insert character. The next 43 bytes are inverse insert characters (ATASCII 255). Every time 
something is stored on the disk, this sector is checked. If the bit is a 1, then the sector is free and 
the information can be placed in that sector. The bit in the bit map is then set to 0. The 45th and 
46th bytes are sectors 360-368. These sectors are reserved for this VTOC and the directory. If 
the directory sectors are changed to ones, they could be written on. The computer would not be 
able to list a directory or load or store programs. 


FILE DIRECTORY FORMAT 

Beginning with sector 361, the computer keeps the names of the programs on the disk. There 
are sixteen bytes used for each entry. Up to eight names can be stored on each sector. There are 
eight sectors set aside for the directory. Up to 64 files or names can be stored on a disk. This 
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means that even if there are free sectors on the disk, the disk will not hold more than 64 programs 
or files. 

Look at sector 361 using the Displaying Sectors program. You should see up to eight file 
names. Before each name, there are some characters. The first byte of the file name is the flag 
byte. If this character is a B, the file is available. If it is a b, the file is locked. If it is an inverse 
heart, the file has been deleted. 

The next two bytes contain the sector count. The second byte is the low byte, the third, the 
high byte. Multiply the ATASCII value of the third byte by 256, and add the ATASCII value of the 
second byte to find out how many sectors are used for the file. 

The fourth and fifth bytes contain the sector number at which this file starts. Again, this is a 
two byte number with the low byte first and the high byte second. Use the ATASCII values of 
these characters to find out which sector the file begins in. 

The next eight bytes are the name of the file. The last three are the extender. There is no 
period separating the name from the extender. When the directory is read into the computer, the 
period is added by the program. If the file name or extender contains more characters than there is 
space for in the directory, the extra characters will be ignored. Table 13-1 shows the format of the 
file directory. 

BOOTING YOUR OWN DISK 

When you place a disk into the drive, and turn on the computer, the drive turns on and a 
program boots. This program could be the DOS or another program. Most commercially available 
machine language programs will boot themselves when you turn the computer on. BASIC 
programs are usually loaded into the computer. 

AUTORUN.SYS 

You may have noticed a program on your ATARI disk called AUTORUN.SYS. If you examine 
the disk directory from various software firms, you may find the AUTORUN.SYS is anywhere 
from one to three or more sectors long. You may have also found that when you write DOS to a 
new disk, the AUTORUN.SYS does not get written to the new disk. It has to be copied. 


Table 13-1. File Directory Format. 
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The purpose of the AUTORUN.SYS is to give the programmer a way to boot a program or 
load a machine language program into the computer during the boot process. Let’s say that you 
have a machine language program that will disable the break key. You want this program executed 
immediately when the system is turned on. If the program had to be loaded by the user and 
executed, chances are it wouldn’t be done. A short routine could be inserted into your BASIC 
program to load and execute this routine, but this would take up memory space and time. 

When you turn your computer on and DOS is loaded in, it checks to see if there is a program 
on the disk called AUTORUN.SYS. If there is, it loads this program and executes it before it turns 
control over to the user. The AUTORUN.SYS program must be written in machine language. It 
cannot be a BASIC program. 

In the following program, you will create your own AUTORUN.SYS. It will change the right 
and left margins on the screen, and the background color before BASIC takes over. 


Listing 13-5. AUTORUN.SYS 


10 REM LISTING 13.5 
20 REM AUTORUN.SYS 

30 REM BY L.M.SCHREIBEE FOR TAB BOOKS 
4 0 0 P E N # 2 v S v 0 9 " D t A U T 0 R U N * S Y S " J E E M 0 P E 
N THE BUFFER TO WRITE THE NEW AUTORUN 
50 PUT # 2 9 255 i PUT #2 v 255 t REM LEADING B 
YTES 

60 PUT il : 2 y 0 i PUT #2 * 6 i REM STARTING AD DR 
ESS 

70 PUT *2y13iPUT #2 96t REM ENDING ADDRE 


c:- e 


n a 


80 FOR B =1 TO 1 AX READ D X REM GET T 
TA FOR THE ROUTINE 

90 PUT #2 s’ D t REM PUT IT IN THE BUFFER 
100 NEXT B X REM CONTINUE THE LOOP 
110 P U T # 2 v 2 2 6 t P U "f # 2 r 2 X R E M A U T 0 A B D R E 

C' r- 

t.) 

12 0 P U T # 2 V 2 2 7 X P U T # 2 t 2 X R E M S T A R T F R 0 M 
THIS ADDRESS 

13 0 P U T # 2 ? 0 j P U T # 2 16 X R E M S "f A R TIN 0 A D B 
RESS 

140 CLOSE #2 X REM CLOSE THE BUFFER •••• PR 
OCRAH GOES TO DISK 
150 END 

2 0 0 D A T A 16 9 v 5 y 13 3 v 8 2 » 1 6 9 ? 3 0 v 13 3 ? 8 3 v 16 
9 v 208 •) 141 v 198 ? 2 v 96 


Line 40 opens the disk buffer to write to the disk. The name of the program is AUTO¬ 
RUN.SYS. If there is a program by that name on the disk, it will be replaced by this one. 

Line 50 puts the first two bytes of this program into the disk buffer. The first two bytes of any 
machine language program is 255. 
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Line 60 places the beginning address of the program into the buffer. The machine language 
program will begin at memory location 1536 (600 hex). 

Line 70 places the ending address of the program into the buffer. The machine language 
program is 14 bytes long, so the ending address will be 1549 (60D hex). 

Line 80 begins the for....next loop that reads the machine language program into the disk 
buffer. There are 14 bytes in this program. 

Line 90 puts each byte into the buffer. 

Line 100 continues the loop until all the bytes have been read and placed into the buffer. 

Line 110 puts the low order address of the autorun routine into the disk buffer. 

Line 120 puts the high order address of the autorun routine into the buffer. 

Line 130 puts the beginning address of the machine language program into the buffer. This is 
the address that will be put into the preceding addresses. For a program to load and run, the 
running address must be stored in memory locations 738 and 739. 

Line 140 closes the disk buffer. When the buffer is closed, its contents will be sent to the 

disk. 

Line 200 contains the machine language program that will be run when the disk is booted in. 

After you enter this program, run it. Be sure that the disk that is in your drive does not have 
an AUTORUN.SYS on it or it will be destroyed. It is best to have a new initialized disk in the 
drive. The DOS must be on the disk. When you run the program, the disk will turn on and you can 
hear the program being saved to the disk. After it is saved, turn the computer off and then turn it 
back on. You will hear the disk boot in. The cursor will move to the right and the screen will turn 
black. The word READY will appear in green. If you load in a program and list it, you will see that 
your margins have moved. See Table 13-2 for the machine language listing of the program. 

Boot Record 

The AUTORUN.SYS is one way to load and execute programs. But, what if you are writing 
programs in machine language, and you do not want a directory on the disk, but do want the 
program to load and run when the disk is turned on? 

In the last chapter, we discussed how the disk was structured. The first sector is called the 
boot sector. This is the sector that the computer will look at to bring in a program from the disk. If 
you copied the DOS on the disk, you have the ATARI boot on this sector. It will bring in the DOS. 
If you placed your own boot on this sector, it will bring in whatever program you want it to. This is 
not something that can be easily accomplished from BASIC, but that’s not to say that it can’t be 
done. If you are ready to place your own boot records on the disks, you must have a good 
understanding of assembly language and how the boot process works. In this chapter, we will only 
describe the boot process. 

The boot sector has its own specific format. The first byte is stored in memory location 576. 
It is not used by the boot and should be set to a zero. The second byte tells the computer how many 
sectors are in the boot. It should include this sector. This number can be any number from 1 to 
255. If it is 256, it will be set to zero. The third and fourth bytes tell the computer where to start 
loading the program. This does not have to be where the program begins, just where to start 
loading the file. The fifth and sixth bytes tell the computer where the program begins. After all the 
sectors for the boot have been loaded, the computer has to know where it should transfer control 
to. This address will be the beginning of the program. The third and fourth bytes and the fifth and 
sixth bytes are two byte addresses. Be sure that the third and fifth bytes contain the low order 
address and the fourth and sixth bytes contain the high order address. 
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Table 13-2. Machine Language Routine for AUTORUN.SYS. 


de?e:i. mail. 

c o d e 

a & s 0 

m b 1 \-.i 

1 a n u a si e 1 i s t :i. n si 


169 

i::; 


LDA 

#5 

y L o a d t h 0 a c c u in u 1 a t o r v w :L t h 

5 * 

133 


ST A 

82 

? S t o r 0 i t i n 1 o c.' a t i a n 8 2 ♦ 


82 




% 


169 


LDA 

#30 

v L a a d t h 0 a e c u iyi u 1 a t o r w :i. t h 

30 ♦ 

30 






133 

q "x 


ST A 

83 

9 S t o r 0 :i. t :L n 1 o c a t i o ri 8 3 ♦ 


169 

• 

LDA 

#208 

9 L.. o a d t h 0 a c c u m u 1 a t o r w :i. t h 

208 • 

208 




• 


141 


ST A 

7.1.0 

y S t o r v 0 :i. t i n !L o c a t :i. a n 710 » 


198 

n 






A*.. 

96 


RTS 


y R 0 1 ij r r i f r' o in t h 0 r o t i n e ♦ 



The following is an example of the structure of a boot record. It is not the complete record. 
0 ignore 

3 number of sectors in boot 
0 low order address 
7 high order address—place boot here 
64 low order address 
21 high order address for initialization 
76 jump to following address 
20 low order byte 
7 high order byte 
3 ?? 

3 ?? 

0 ?? 

124 ?? 

26 ?? 

1 data—loads into the Y register 
24 
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0 

125 

203 data 
7 

172 load the Y index use-next address 
14 low order byte for address 
7 high order byte for address 

240 branch if it’s 0 
54 ahead 54 bytes 

This portion of a disk boot shows how the information in the first sector is used. The first 
byte (0) is ignored. The second byte indicates how many sectors are in this boot. This number is 
stored at location 577. The next two bytes are stored at locations 578 and 579. They tell the 
computer where this boot should begin. The first six bytes and all the byte following will be 
moved to the location in memory beginning with the address specified here. The next two bytes 
are the initialization bytes. After the boot is executed, the address in this memory location will be 
jumped through. The next instruction in the boot is a jump. Once the three sectors have been 
moved into memory the computer will perform a jump subroutine. The address that it will jump to 
is the sixth address after the beginning address. In this case it is location 1798 (706 hex). The 
instruction at this address is to jump to memory location 1824 (720 hex). At this location, the 
computer will load the Y index with the value stored at 1812 (714 hex). If the value is zero, the 
computer will move ahead 54 bytes. If we count 15 bytes down in the table, we will see that the 
value at that location is a one. The computer will proceed to the next instruction. 

The boot process then consists of: 

1. Reading the first sector and storing the first six bytes, which indicate the number of 
sectors, the load address, and the initialization address. 

2. Placing the boot sectors into memory beginning with the location specified in the third 
and fourth bytes of the boot sector. 

3. Jumping to the subroutine that begins in the seventh location after the beginning of the 
boot. 

4. Jumping through the subroutine whose address is stored in locations 12 and 13 (fifth and 
sixth bytes of the boot record). 

5. Transferring control to the program by jumping to the address in locations 14 and 15. 

The machine language program loaded into the computer will now be fully operational. If the 

addresses are set correctly when system reset key is pressed, the program will restart itself. If 
they are not, the drive may turn on and the computer may try to boot the program again, or the 
computer will go to BASIC or the memo pad. 
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Chapter 14 


Cassette Use 


Like the disk, the cassette is a convenient form of storage that can be utilized more effectively 
when the way the computer handles it, and its physical structure are understood. 

THE CASSETTE HANDLER 

The cassette handler is similar to the disk manager. Files can be written to or read from the 
cassette. The buffer can be opened for get and put commands. Programs can be loaded using 
BASIC or using an autoload command. However, there are some important differences between 
the disk and cassette. The cassette can only read and/or write data to the portion of tape under the 
recorder head. Files cannot be stored or retrieved from just any position. When a program is 
saved to the cassette, it is saved in one continuous stream. There is no positioning of the head. 
You cannot specify tracks like you can point to sectors and bytes on the disk. Likewise, you can 
only read what is passing under the cassette head. You cannot point to only one section of tape like 
you can read in one sector from the disk. The cassette is, however, a fairly reliable way to store 
and retrieve information. 

Format of Data 

If you have a recorder, save a program to it. It doesn’t have to be very long—four or five lines 
will do. After the program is saved, rewind the tape and enter these commands in the direct mode: 

OPEN #7,4,0,“C:”:FOR X=1 TO 128:GET #7,B:? B;“ ”;:NEXT X:CLOSE #7 

This opens the cassette for a read. Now press the play button on the recorder and the return 
key on the keyboard. You will hear one tone. Press the return key again. After you hear a record of 
data being read in, you will see numbers being printed on the screen. This is the code for the 
program that was saved. The computer is printing it from the cassette buffer, in the same manner 
as it was printed from the disk buffer. 

Now enter this without clearing the screen: 

FOR X=0 TO 130:?PEEK(1021+X);“ ”;:NEXT X 
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The first three bytes that are printed on the screen are different from the first three bytes 
that were printed from the buffer. But, if you compare the first byte of the buffer with the fourth 
byte, you will see that both number patterns are identical. Memory location 1021 begins the 
cassette buffer. The buffer is 131 bytes long. 

The first two bytes in the buffer are 85. These two bytes are fixed and are used by the 
computer to measure the speed of the cassette. The third byte is the control byte. If this byte is 
252, the record is full—128 bytes. A 250 in this position indicates a partially full record and a 254 
is an end of file record. 

The first bytes after the speed and control bytes for the first record consist of the table 
entries. This includes the variable table, the value table, etc. The values are adjusted by the 
amount of memory in your machine. This is why a program that requires more storage memory 
than your machine has will produce an error message immediately when you try loading it rather 
than half way through the load. 

The last byte that the computer reads from the cassette is a checksum. When the program 
was saved to the cassette, every byte that was sent to the cassette in the 128 byte record was 
added to the previous bytes. The two markers are also included in the addition. After the two 
markers, the control byte, and the record were sent to the cassette, the sum of the bytes were also 
sent. When the records are read in, the bytes are added together again. If the sum of the bytes 
match the checksum byte that is read in, then the record is assumed to be correct and the 
computer will continue with the loading process. If the two bytes do not match, the load will stop 
and an error message will appear on the screen. 

Cassette Frames 

Each record of 128 bytes is considered a frame. The speed at which the data is sent or 
received is called the baud rate. The ATARI uses the baud rate of 600. This means that 600 bits 
are sent per second. (Each byte is 8 bits). The two marker bytes are read in by the computer. The 
computer determines how long it took to read them in and calculates the correct baud rate for the 
tape. It does this with every frame of data that is read in. The input baud rates can be adjusted to 
read faster or slower. This adjustment process allows for variations in motor speeds, stretched 
tape, etc. It does not, however, allow for alignment problems between the recorder that the 
program was originally saved on and the one that it is being read on. 

You may have noticed that when you CSAVE a program to cassette, the records seem to be 
sent faster than when you use the list command. There are two different modes that the computer 
can use when sending records to the cassette. One is called the normal IRG (Inter-Record Gap), 
and the other is the short IRG. The computer uses the short IRG for the CSAVE and CLOAD 
commands. The computer reads in the record, checks the checksum, places it in RAM, and goes 
back for another record. The recorder is running the entire time. The computer must do its work 
quickly so that it won’t miss the next record. 

When the computer uses the normal IRG for saving records to the tape, the recorder stops 
after every record is read into the computer. The information can be processed; then next record 
can be read in. The baud rate for saving and reading the data is the same for both modes. It is the 
time between records that varies. In the normal mode there is about 3 seconds of tone between 
records. In the short mode there is about l /i of a second of tone time between records. 

The IRG is set up by the computer when the save or load command is entered. If the wrong 
command is entered for the tape, the program will not load and an error message will be displayed 
on the screen. 
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BOOTING YOUR OWN CASSETTES 

There are two different ways to make your cassettes load and run automatically. The first 
way is with a BASIC program. A short boot program is saved to the tape. Then, without moving 
the tape, the second program is saved to the cassette. By using the RUN “C:” command, the boot 
program will load, run, and load in the second program. The following program is a short boot 
program that will load and run a second program. 


Listing 14-1. BASIC Boot Load 


10 
20 I 
30 I 
40 ( 


EM LISTING 14.1 
EM BASIC BOOT LOAD 
'<EM BY L.M.SCHREIBER FOR TAB 
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50 POKE 65»o:POKE 
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. . —I 

} •* .. 
y x ) 


% DRAW 
10 y 7 % COLO 


Line 40 sets the graphics mode to 0. The graphics mode must be set before plots and 
drawtos.. The background color and border colors are changed. 

Line 50 pokes 65 with a 0. This will turn off the noise channel and you won’t be able to hear 
the program loading. This line also removes the cursor from the screen. 

Line 60 prints the copyright notice on the screen. 

Lines 70-80 prints your message on the screen. 

Line 90 sets the color to 35. This is the ATASCII value of the pound sign. Using the plot and 
drawto commands, a border is drawn around your message. 

Line 100 turns the cursor back on and places a carriage return in the location that holds the 
last key entered. 

Line 110 executes the RUN “C:” command. You won’t have to press the return key because 
the code is already poked into location 764. 

The program that is saved on the tape after this boot program had to be saved using the 
SAVE “C:” command. If it was CSAVEd, this procedure won’t work. If you want the next program 
to load in only, and not run, change line 110 to CLOAD, and be sure that the program that you want 
to load was CSAVEd to the cassette. 

The noise location was set to zero in this program so that music or instructions could be 
heard over the television speaker. This command is not needed if you will not be using the second 
track on the cassette. 
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Boot Record 

If you wrote a machine language program that you want to load in from cassette without using 
the editor/assembler, you need to write a boot record as the first record of the cassette program. 
The boot record for the cassette is almost identical to that for the disk. 

There are six bytes for the first record of the boot. The first byte is ignored. The second byte 
contains the number of records that should be initially read. The third and fourth bytes contain the 
address where the boot records should be stored. The fifth and sixth bytes contain the address 
that should take control of the program after the boot is completed. 

The following is the partial coding of a machine language program’s boot record. 

0 ignore 

32 number of records 

191 low order memory load address 

11 * high order memory load address 

184 low order initialize address 

27 high order initialize address 

169 load the accumulator with next byte 

60 

141 store it in the next address 

2 low order address 

211 high order address 

169 load the accumulator with next byte 

3 

141 store it in the next address 

15 low order address 

210 high order address 

The computer will ignore the leading zero. The next number, 32, is the number of records 
that will be read in. This value will be saved. The computer will begin storing these records at 
location 3007. The fifth and sixth bytes will be stored at memory locations 2 and 3. After all the 
records are read in, the computer will issue a jump to the subroutine at the seventh byte loaded in. 
This byte will load the accumulator with 60 and store this value at location 54018. This shuts off 
the cassette recorder. The program continues. When it has returned, the computer will jump 
through the initialization routine. The address for this routine was stored in locations 2 and 3. 
Once the initialization is complete, the computer will jump through the address at location 14-15 
and begin the program. 

Although it is possible to write a BASIC program that will load and automatically run a 
machine language program, it really should be done using the editor/assembler. The procedure to 
load a cassette with a machine language boot on it is: 

Turn off the computer. 

Hold down the start key and turn the computer on. 

When you hear the single tone, press the play button on the recorder and press the return key 
on the computer. 

The records on the tape must be created using the short mode for it to load properly. 
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USING THE CASSETTE WITH SOUND 


In the last program, we used a BASIC boot program to bring in the program. Using the RUN 
“C:” command, the computer loaded in the first program and ran it. This program contained the 
instruction to either CLOAD or RUN “C:” the next program on the tape. It also poked the 
memory location that directed the sound of the data so that the program loaded silently. 

The ATARI recorder is a stereo recorder. Most other computers use a monaurial recorder. 
With a monaurial recorder, the computer places two tracks of data on the tape, one track on one 
half and one on the other. With a stereo recorder, the computer only uses half of the track for data. 
A stereo recorder places four tracks on each tape, two on one half of the tape and two on the other. 
See Fig. 14-1 for the data tracks. 

The other two tracks on the tape are left blank. They can have sound or spoken instructions 
on them if you have the facilities to record and duplicate stereo tapes. The procedure is fairly 
simple, but it does require some planning and timing. 

First, load the BASIC boot program into the computer. Save it to a new cassette using the 
SAVE “C:” command. After the BASIC boot program has been saved to the cassette, load in the 
program that you want to save. If you have a disk drive, you can load the program in from the disk. 
If you have only a cassette recorder, carefully remove the new cassette from the recorder and 
place the cassette with the program on it in the recorder and load it into the computer. You want to 
handle the cassette with the new program on it carefully because the tape is in position for the 
second program. If you rewind the tape, you will be saving the program over the BASIC boot 
program. If the tape advances too far, there could be a loading problem. 

Once the second program is loaded into the computer, it can be saved to the new tape with 
either the SAVE “C:” command or the CSAVE command. If your boot program is using the RUN 
“C:” command, then use the SAVE “C:” command and the second program will run immediately 
after it is loaded in. If your BASIC boot program uses the CLOAD command, CSAVE your 
program to the cassette. 

After the second program has been saved, rewind the cassette, type RUN “C:”, press the 
play button on the recorder and the return key on the computer twice. If you have not poked 
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Fig. 14-1. Track formats on cassette. 
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location 65 with a 0, you will hear the BASIC boot program load in. The screen will change colors 
and display your message on the screen. The tone will sound and the computer will begin to load 
in the second program. You don’t even have to press the return key. The BASIC boot program did 
it all. Now listen to the program load. If you can hear it, you either didn’t have a POKE 65,0 in the 
boot program, have a problem with separation in the cassette recorder, or have very good ears. 
The only sounds that should come through the television speaker are the sounds recorded on the 
left track. Since we did not place any sounds there, you shouldn’t hear any. 

Adding Sounds or Instructions 

In order to record sounds, music, or instructions on the left track, you need a stereo cassette 
recorder/duplicator. Place the cassette into the recorder and listen to it. First you will hear a pure 
tone. Then you will hear the date. Each record is separated by the pure tone. The BASIC boot 
program will be about four or five records long. The last record of this program will have a slightly 
different sound. After listening to the records several times, you will be able to tell the difference 
between the program records and the ending record. After the last record for the first program, 
you will hear the pure tone again for a longer period of time before you hear the first record. This 
is the tone that the computer sends out before it starts to send the program. It seems longer here 
because there is no leader tape between the first and second program. This is where you should 
start the music, sound, or instructions on the left track. 

Place a new tape into deck B of the recorder/duplicator. Place the tape that you have just 
saved the two programs on into deck A. Press the play and record buttons for cassette B and the 
play button for cassette A. If you are using a microphone, be sure that it is connected to the left 
track. If you will be recording music directly, be sure that your patch cord is plugged in for the left 
channel. Listen to the cassette as it is being duplicated from deck A to deck B. When you hear the 
tone for the beginning of the second program, you can begin speaking, playing the music, etc. Be 
sure to stop recording on the left track just before the last record. Otherwise, the recorder will 
stop loading in the program and you will not hear the remaining words or music. 

Rewind both cassettes, remove the newly created cassette from deck B and place it in your 
program recorder. Type RUN “C:” and press the return key. This time when the second program 
loads into the machine, you should hear your music, instructions, or whatever you recorded on the 
left track coming through the television speaker. 

Because of the speed variances between recording machines, head alignments, and the 
nature of cassettes, you may have to repeat the duplication process before you create a tape that 
will load. This process cannot be used with a high speed tape duplicator. 

Voice Synchronization 

Another use for the cassette recorder is for voice synchronization. Poking memory location 
54018 with 52, turns on the motor on the recorder. Poking that location with a 60 turns the motor 
off. 

The following program turns the recorder on and off at the correct time. It is a spelling 
program. To use this program, you will need a recorder with a microphone. First enter this 
program into the computer and save it on tape. Either turn the tape over and rewind it so that you 
are at the beginning of the back side, or just remove the tape from the program recorder and place 
it in the other recorder. Now record the words in the data line onto the tape. Space the words at 
five second intervals. Now rewind the cassette to the beginning of the words and run the program. 
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Listing 14-2. Listen and Spell 


10 REM LISTING 14,2 

20 REM LISTEN AND SPELL 

30 REM BY L,M,SCHREIRER FOR TAB BOOKS 

4 0 DIM U 0 R D $ (15 ) y A N S * ( 15 ) 

5 0 N=N •{• 1 ? ? " > C L E A R > " ? IF N > 10 T H E N 17 0 1 
REM CLEAR THE SCREEN 

60 POSITION 3 y 5 ? ? “LISTEN TO THE WORD" 

70 POKE 54018y52?REM TURN ON THE RECOR 
DER 

80 FOR T-I TO 2000?NEXT T?REM LET IT R 
UN 

90 POKE 54018y60?REM TURN IT OFF 
100 W-0? READ WORD* 

110 ? ?? "WHAT WAS THE WORD"?REM ASK F 
OR WORD 

120 INPUT ANS$ 

13 0 IF W 0 R D * ~ A N S $ T H E N P 0 SIT10 N 3 y 2 0 ? ? 
" V E R Y G 0 0 D " ? F 0 R T »1 T 0 5 0 0 ? N E X T T ? G 0 T 

0 50 

14 0 W - W +1 ? IF W < > 3 T H E N 1.10 

150 POSITION 3y20J? "THE WORD WAS — " 
y WORD* 

1.60 FOR 7 -1 TO 500? NEXT T ? GOTO 50 
1.7 0 P 0 SIT10 N 3 y 10 ? ? " Y 0 U H A V E FINIS H E D 
YOUR SPELLING FOR TODAY!!!" 


2 0 0 D A T A B 0 0 K S y F A 0 0 RIT E y F 0 0 T B A L L , H 0 B BI 
E S y C A R NI '■■> AI... y M 0 U N T AIN y B10 NIC y F AIL U R E y A T 
TITUBE y SECURE 


Line 40 sets aside the string space for the word (WORDS) and the answer (ANS$). 

Line 50 adds one to the value in N. This counts the words as they are being given. If the value 
is greater than 10, then all the words have been given and the program will go to the end at line 170 
after the screen is cleared. 

Line 60 instructs the user to listen to the word. 

Line 70 turns on the cassette recorder by poking location 54018 with a 52. The play button on 
the recorder must be pressed down for this program to work. If that button is not down, you will 
hear a click from the television speaker, but no word. 

Line 80 is a timing loop. This is set for about five seconds. You may have to adjust this 
number for your own program recorder. 

Line 90 turns the recorder back off. 

Line 100 sets the variable W to zero. This variable will count the number of times the user 
tries to spell the word. It also reads the word from the data line. This is the word that was just 
spoken on the tape. 
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Line 110 asks the user for the word. 

Line 120 waits for an entry to be made. 

Line 130 checks the answer entered against the word. If it is correct, a message will be 
printed on the screen; the program will pause and then go on to line 50 for another word. 

Line 140 adds one to the variable W and checks to see is this was the third try. If it wasn’t, the 
program goes to line 110 and asks for the word to be entered again. 

Line 150 prints the correct word if the user tried to spell it three times and couldn’t. 

Line 160 is a timing loop to give the user time to study the word. Then the program continues 
at line 50. 

Line 170 tells the user that all the words have been spelled. 

Line 200 contains the words used in this program. 

This program can be a very effective way to learn, but it does have its drawbacks. In this 
case, the words must be asked in the same order every time. After a while, the user will know the 
order of the words. Since the tape cannot be rewound or fastforwarded from the computer, the 
information will always be presented in the same order. If the word was entered wrong, or if you 
want to hear it again, the tape cannot be rewound to that word. 

On the other hand, if you are presenting a very structured lesson or a story with animation, 
there would be no need to rewind or repeat parts of the tape. 
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A 

Abacus, 1 
Animation, 45 

Animation in the Text Mode program, 
55 

Animation programs, 48, 53 
Animation with strings, 91 
ANTIC chip, 9 
ANTIC instruction set, 12 
ANTIC 3 mode, 17 
ANTIC 3 program, 17 
Assembly language listing to move 
character set from ROM to RAM, 
39 

AUTORUN/SYS, 189 
AUTORUN/SYS, machine language 
routine for, 192 

AUTORUN/SYS program, 190 

B 

BASIC, 79 

BASIC Boot Load program, 197 
BASIC Table programs, 82-86 
BASIC token commands, 79, 80 
Binary number system, 1 
Blank, horizontal, 11, 107 
Blank, vertical, 11-107 
Boot, cassette, 197 
Boot, disk, 189 
Boot record, cassette, 198 
Boot sector, 191 
Buffer, disk, 179 

C 

Calendar program, 181 
Carousel program, 60, 64 
Cassette boot, 197 
Cassette handler, 195 

Characters, hardware values of, 23 
Central processing unit, 9 
Character set, 16 


Character set, editing, 26 
Character set construction, 25 
Character Set Editor program, 28 
Character set moved from ROM to 
RAM, 39 
Chip, ANTIC, 9 
Chip, CTIA, 9, 16 
Chip, GTIA, 10, 16 
Chip, POKEY, 9 
Chips, large-scale integrated, 9 
Code, hardware, 168 
Code, keyboard, 166 
Color Artifacting program, 23 
Color Service Routine, 109 
Color text modes, 19 
Command, DRAWTO, 15 
Command, input, 161 
Command, locate, 11, 171 
Command, open, 177 
Commands, BASIC token, 79, 80 
Commands, XIO, 181 
Control codes, ATASCII, 172 
Conversions program, numbers, 3 
Counting systems, 1 
Course Horizontal Scroll program, 123 
Course Vertical Scroll program, 121 
CTIA chip, 10, 16 


D 

Data for Exclamation Point program, 
26 

Data format, cassette, 195 

Decay, 153 

Directory, file, 187 

Directory Listing program, 178 

Disk boot, 189 

Disk buffer, 179 

Disk file manager, 177 

Disk handler, 185 

Displaying Sectors program, 185 

Display list, 10 


ndex 


Display list interrupts, 107 
Display modes, 20 
Distortion, 153 

Double Character Sets program, 112 
DRAWTO command, 15 

E 

Editing the character set, 26 
Exclamation point, 26 

F 

Farmer, and the Duck, Fox and Grain 
Puzzle program, 91 
File directory, 187 
File management system, 187 
File manager, disk, 177 
File structures, 81 

Fine Horizontal Scroll programs, 129, 
131 

Fine Vertical Scroll: Down program, 
127 

Fine Vertical Scroll program, 126 
Frames, cassette, 196 

G 

Gap, inter-record, 196 
Graphic modes, 16 
Graphics modes program, mixed, 13 
GTIA chip, 10, 16 

H 

Handler, disk, 185 
Hardware code, 168 
Hardware registers, 108 
Hexadecimal number system, 2 
Horizontal blank, 11, 107 
Horizontal Blank, Machine Language 
Subroutine, 143 

I 

Input command, 161 
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Input/output, central, 177 
Input/output control buffer, 177 
Instruction set, ANTIC, 12 
Interrupt routine to flash inverse 
characters, 116 
Interrupts, display list, 107 
Invisible graphic modes, 36 

K 

Keyboard code, 166 

Keyboard Conversion program, 167 

Keyboard interpretation, 161 

L 

Large-scale integrated chips, 9 

Letter Attack program, 169 

List, display, 10 

Listen and Spell program, 201 

Locate, Poke, and Peek program, 171 

Locate command, 11, 171 

Loudness, 153 

M 

Machine language listing, moving 
players up and down, 77 
Machine language subroutine, Hori¬ 
zontal Blank, 143 

Machine language subroutine for ver¬ 
tical blank, 144 

Machine language subroutines, 99 
Memory addresses, screen, 9, 11 
Memory locations, screen, 174 
Mirror Images Routine, 113 
Missiles, 14, 61 
Mixed Modes program, 13 
Modes, display, 20 
Modes, graphic, 16 
Modes, invisible graphic, 36 
Modes, nontext, 22 
Modes, text, 16 

Move Player/Missile Up/Down pro¬ 
gram, 100 

Moving Players program, 117 
Moving players up and down, machine 
language listing, 77 
Multicolor Characters program, 37 
Music: Machine Language Subrou¬ 
tine, 157 

N 

Nontext modes, 22 
Number system, binary, 1 
Number system, hexadecimal, 2 

0 

Open command, 177 
Output buffer, 85 
Overscan, 10 

P 

Page flipping, 133 
Pitch, 153 


Pixels, 12 

Player/missile graphics, 14, 61 

Player/missile priority order, 69 

Player/Missile Strings program, 102 

Players, 14, 61 

Playfield, 14, 128 

Pointer, 87 

POKEY chip, 9 

Precise Timing Programs, 114, 115 
Print form Disk program, 180 
Printing Control Characters program, 
174 

Priority order, player/missile, 69 
Program, Animation in the Text Mode, 
55 

Program, ANTIC 3, 17 
Program, AUTORUN/SYS, 190 
Program, BASIC Boot Load, 197 
Program, BASIC Tables, 82-86 
Program, Calendar, 181 
Program, Carousel, 60, 64 
Program, Character Set Editor, 28 
Program, Color Artifacting, 23 
Program, Color Service Routine, 109 
Program, Conversions, 3 
Program, Course Horizontal Scroll, 
123 

Program, Course Vertical Scroll, 121 
Program, Data for Exclamation point, 
26 

Program, Directory Listing, 178 
Program, displaying Sectors, 185 
Program, Double Character Sets, 112 
Program, Fine Horizontal Scroll, 129, 
131 

Program, Fine Vertical Scroll, 126 
Program, Fine Vertical Scroll:Down, 
127 

Program, Keyboard Conversion, 167 
Program, Letter Attack, 169 
Program, Listen and Spell, 201 
Program, Locate, Poke, and Peek, 
171 

Program, Mirror Images Routine, 113 
Program, Mixed Modes, 13 
Program, Move Character Set, 100 
Program, Move Player/Missile Up/ 
Down, 100 

Program, Moving Players, 117 
Program, Multicolor Characters, 37 
Program, Music: Machine Language 
Subroutine, 157 

Program, Precise Timing, 114, 115 
Program, Print from Disk, 180 
Program, Printing Control Characters, 
174 

Program, Read the Keyboard, 161 
Program, Simple Page Flipping: Two 
Different Modes, 135 
Program, Simultaneous Page Flip¬ 
ping: Machine Language Sub¬ 
routine, 141 


Program, Slide Editor, 145 
Program, Slide Show, 148 
Program, Sounds, 154 
Program, Sounds with Attack and 
Decay, 155 

Program, The Birds, 70 
Program, The Farmer and the Duck, 
Fox, and Grain Puzzle, 91 
Program, Tiles, 163 
Program, Variations on Tones, 157 
Programs, Simultaneous Page Flip¬ 
ping, 137-139 

R 

Raster scan, 11, 107 

Read the Keyboard Program, 161 

Register, shadow, 108 

Registers, hardware, 108 

Registers, sound, 156 

Relocating strings, 101 

ROM, 16 

ROM to RAM, character set moved 
from, 39 

Routine, deferred vertical blank, 144 
Routine, immediate vertical blank, 144 
Runtime stack, 88 

S 

Screen displays, memory mapped, 9 
Screen flipping, 133 
Screen flipping, machine language 
subroutine for, 140 
Screen Flipping program, 133 
Screen memory locations, 174 
Scrolling, course, 121, 123 
Scrolling, fine, 125, 129 
Scrolling, horizontal, 121, 123, 129 
Scrolling, vertical, 121, 125 
Service interrupt to flash inverse 
characters, 116 
Shadow register, 108 
Simple Animation program, 48, 53 
Simple Page Flipping: Two Different 
Modes program, 135 
Simultaneous Page Flipping: Machine 
Language Subroutine program, 
141 

Simultaneous Page Flipping pro¬ 
grams, 137-139 
Slide Editor program, 145 
Slides, creating, 144 
Slide Show program, 148 
Sound, 153 

Sound, direct access too, 156 
Sound characteristics, attack, 153 
Sound characteristics, decay, 153 
Sound characteristics, release, 153 
Sound characteristics, sustain, 153 
Sounds on tape, 200 
Sounds program, 154 
Sounds with Attack and Decay pro¬ 
gram, 155 
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Speeding up a program, 88 
Statement table, 86 
String/array area, 84 
Strings, animation using, 91 
Strings, relocating, 101 
Subroutines, 89 

Subroutines, machine language, 

T 

Text modes, 16 


The Birds program, 70 
Tiles program, 163 
Token commands, 79, 80 
Tone generator registers, 157 
Track format, disk, 187 

99 V 

Variable name table, 79 
Variables, 81 

Variations on Tones program, 157 


Vertical blank, 11, 107 
Vertical blank, machine language sub¬ 
routine for, 144 
Voice, 153 

Voice synchronization, 200 
Volume, 153 

Volume table of contents, disk, 187 

X 

XIO commands, 181 
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Advanced Programming Techniques for 
Your ATARI ®, including Graphics and Voice Programs 


If you are intrigued with the possibilities of the programs included in Advanced 
Programming Techniques for Your ATARI ®, including Graphics and Voice Pro¬ 
grams (TAB Book No. 1545), you should definitely consider having the ready-to-run 
disk containing the software applications. This software is guaranteed free of man¬ 
ufacturer’s defects. (If you have any problems, return the disk within 30 days and 
we’ll send you a new one.) Not only will you save the time and effort of typing the 
programs, the disk eliminates the possibility of errors that can prevent the pro¬ 
grams from functioning. Interested? 


Available on disk for the ATARI 400 or 800, 32K at $29.95 for each disk plus $1.00 
each shipping and handling. 


I’m interested. Send me: I 

-disk for Advanced Programming Techniques for Your ATARI ®, includ- ■ 

ing Graphics and Voice Programs (6313S). ! 

-Check/Money Order enclosed for $_($29.95 plus $1.00 each ■ 

for shipping and handling) | 

_VISA _MasterCard | 

Acct. No. -Expires_I 

Name_j 

Address_._! 

City-State-Zip_I 

Signature_| 

Mail To: TAB BOOKS Inc. | 

Blue Ridge Summit, PA 17214 I 

(Pa. add 6% sales tax. Orders outside U.S. must be prepaid with international money orders in U.S. dollars.) 

TAB 1 545 








Advanced Programming Techniques for Your ATARI® 
including Graphics and Voice Programs 

by Linda M. Schreiber 

• Get the most from your ATARI’S sound and graphics capabilities for both 
practical and entertainment purposes! 

• Master the special techniques that let you write your own advanced programs 
for almost any application you can think of! 

• Go beyond the limitations imposed by BASIC ... to become the master of 
your machine rather than merely its user! 

Here’s a book that shows you how to understand the special characteristics of 
your ATARI and how to use them for all sorts of new and exciting sound and graphics 
effects. You can create your own character sets . . . mix graphics modes . . . use 
player/missile graphics and screen flipping . . . create animated games . . . under¬ 
stand and use interrupts . . . create your own self-booting disk and cassette 
programs . . . even enter a machine language subroutine to play music while a 
BASIC program is running! 

If you have a good understanding of BASIC but want to go beyond the limita¬ 
tions it imposes, this book is the place to begin. You’ll learn to manipulate your 
machine using professional tips and tricks perfected by an author thoroughly knowl¬ 
edgeable in both program design and the ATARI’S capabilities. Every program is 
described in detail so that you’ll be able to use the illustrated techniques to begin 
writing your own original programs. You’ll even find a listing of all ATARI memory 
locations used by the operating system, discover how to change their values for 
different programming effects, and learn how to use the disk file structure to give you 
control over the drive. EVERYTHING you need to become an advanced program¬ 
mer, able to use all of your ATARI’S unique capabilities, is included in this outstand¬ 
ing sourcebook! 

Linda M. Schreiber is a professional programmer and expert on microcomput¬ 
ers. She is the author of TAB’S ATARI Programming . . . with 55 Programs. 
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